Activar facturación electrónica en cuenta conectada

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.

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

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

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 null

Proveedor de facturación fiscal

registration_typeenum or null

Tipo de registro de facturación electrónica

activation_typeenum or null

Flujo usado para activar facturación electrónica

statusenum

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

status_noticestring or null

Mensaje público sobre el estado actual

enabledboolean

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

ready_to_invoiceboolean

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

missing_requirementslist of strings

Requisitos públicos pendientes antes de poder emitir facturas

establishmentstring or null

Código de establecimiento usado para emitir facturas

Errors

400

Bad Request Error

404

Not Found Error