Skip to main content

​
POST /api/sat-descarga/register

Registra las credenciales FIEL (certificado .cer y llave privada .key) para un perfil, permitiendo la descarga automática de facturas desde el SAT.

​
Autenticación

Requiere autenticación con Bearer token y acceso al plan con descarga masiva SAT.

​
Body Parameters

​
profile_id
string
required
UUID del perfil al que se asociarán las credenciales FIEL.
​
certificate_base64
string
required
Contenido del archivo .cer (certificado) codificado en Base64.
​
private_key_base64
string
required
Contenido del archivo .key (llave privada) codificado en Base64.
​
password
string
required
Contraseña de la llave privada.

​
Response

​
message
string
Mensaje de confirmación.
​
profile_id
string
UUID del perfil para el que se registraron las credenciales.

​
Códigos de Estado

  • 200 - Credenciales registradas correctamente
  • 400 - Parámetros inválidos o falta configuración
  • 401 - No autenticado
  • 404 - Perfil no encontrado
  • 500 - Error del servidor
curl --request POST \
  --url 'https://api.contafy.com/api/sat-descarga/register' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "123e4567-e89b-12d3-a456-426614174000",
    "certificate_base64": "MIIFuzCCA6OgAwIBAgIUMzAwMDEwMDA...",
    "private_key_base64": "MIIEvgIBADANBgkqhkiG9w0BAQEFA...",
    "password": "tu_contraseña_fiel"
  }'

{
  "message": "Credenciales FIEL registradas correctamente",
  "profile_id": "123e4567-e89b-12d3-a456-426614174000"
}

​
POST /api/sat-descarga/trigger/:profile_id

Dispara una sincronización manual de facturas desde el SAT para un perfil específico.

​
Autenticación

Requiere autenticación con Bearer token y acceso al plan con descarga masiva SAT.

​
Path Parameters

​
profile_id
string
required
UUID del perfil para el que se desea sincronizar facturas.

​
Response

​
message
string
Mensaje indicando el estado de la sincronización.
​
profile_id
string
UUID del perfil sincronizado.
​
status
string
Estado de la sincronización.

​
Códigos de Estado

  • 200 - Sincronización iniciada
  • 401 - No autenticado
  • 404 - Perfil no encontrado
  • 500 - Error del servidor
curl --request POST \
  --url 'https://api.contafy.com/api/sat-descarga/trigger/123e4567-e89b-12d3-a456-426614174000' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "message": "Sincronización iniciada",
  "profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "in_progress"
}

​
GET /api/sat-descarga/status/:profile_id

Obtiene el estado actual de la sincronización SAT para un perfil.

​
Autenticación

Requiere autenticación con Bearer token y acceso al plan con descarga masiva SAT.

​
Path Parameters

​
profile_id
string
required
UUID del perfil.

​
Response

​
profile_id
string
UUID del perfil.
​
last_sync_at
string
Fecha y hora de la última sincronización exitosa (formato ISO 8601).
​
sync_status
string
Estado actual de la sincronización: "idle", "in_progress", "completed", o "error".
​
invoices_downloaded
integer
Número de facturas descargadas en la última sincronización.
​
has_credentials
boolean
Indica si el perfil tiene credenciales FIEL registradas.

​
Códigos de Estado

  • 200 - Estado recuperado exitosamente
  • 401 - No autenticado
  • 404 - Perfil no encontrado
  • 500 - Error del servidor
curl --request GET \
  --url 'https://api.contafy.com/api/sat-descarga/status/123e4567-e89b-12d3-a456-426614174000' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "last_sync_at": "2026-03-07T10:30:00.000Z",
  "sync_status": "completed",
  "invoices_downloaded": 45,
  "has_credentials": true
}

Build docs developers (and LLMs) love

Get started for freeTalk to us