Activar facturación electrónica en cuenta conectada

PUT

https://app.recurrente.com/api/connected_accounts/:connected_account_id/tax_invoicing

PUT

/api/connected_accounts/:connected_account_id/tax_invoicing

curl -X PUT https://app.recurrente.com/api/connected_accounts/connected_account_id/tax_invoicing \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F registration_type="managed" \
     -F activation_type="manual" \
     -F firma_electronica=@"(archivo .pfx)" \
     -F pfx_password="pfx-password" \
     -F establishment="1"

{
  "provider": "recurrente",
  "registration_type": "managed",
  "activation_type": "automatic",
  "status": "ready_to_upload",
  "status_notice": "Estamos activando tu facturación. Te notificaremos cuando esté lista.",
  "enabled": true,
  "ready_to_invoice": false,
  "missing_requirements": [
    "API keys",
    "establishments",
    "tax phrases"
  ],
  "establishment": "1"
}

Configura la facturación electrónica administrada por Recurrente para una cuenta conectada. En v1 registration_type debe ser managed.

Cuando FEL está listo para emitir se envía tax_invoice_settings.enabled. La respuesta inicial puede indicar que la activación sigue en proceso; enabled: true por sí solo no significa que FEL esté listo.

Después de completar la activación, los checkouts creados con X-ACCOUNT-ID emitirán factura fiscal desde la cuenta conectada.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

connected_account_idstringRequired

ID de la cuenta conectada

Request

This endpoint expects a multipart form containing an optional file.

registration_typeenumRequired

En v1 solo se permite facturación administrada por Recurrente

Allowed values:

activation_typeenumRequired

automatic descarga la firma desde SAT usando sat_password. manual usa el archivo PFX enviado en firma_electronica.

Allowed values:

sat_passwordstringOptional

Requerido cuando activation_type es automatic

firma_electronicafileOptional

Archivo PFX requerido cuando activation_type es manual

pfx_passwordstringOptional

Contraseña del PFX requerida cuando activation_type es manual

establishmentstringOptional

Código de establecimiento. Si se omite, Recurrente usa 1.

Response

Estado actualizado de facturación electrónica

providerenum or nullOptional

Proveedor de facturación fiscal

Allowed values:

registration_typeenum or nullOptional

Tipo de registro de facturación electrónica

Allowed values:

activation_typeenum or nullOptional

Flujo usado para activar facturación electrónica

Allowed values:

statusenumOptional

Estado público de la activación de facturación electrónica

status_noticestring or nullOptional

Mensaje público sobre el estado actual

enabledbooleanOptional

Indica si la facturación fiscal está habilitada en la cuenta

ready_to_invoicebooleanOptional

Indica si la cuenta ya tiene credenciales y datos fiscales listos para emitir facturas

missing_requirementslist of stringsOptional

Requisitos públicos pendientes antes de poder emitir facturas

establishmentstring or nullOptional

Código de establecimiento usado para emitir facturas

Errors

400

Bad Request Error

404

Not Found Error