---
title: "Activar facturación electrónica en cuenta conectada"
method: PUT
path: "/connected_accounts/{connected_account_id}/tax_invoicing"
tags: ["connectedAccounts"]
---

# Activar facturación electrónica en cuenta conectada

`PUT /connected_accounts/{connected_account_id}/tax_invoicing`

## Request

- Base URL: `https://app.recurrente.com/api`
- URL: `https://app.recurrente.com/api/connected_accounts/{connected_account_id}/tax_invoicing`
- Auth: API key in header `X-SECRET-KEY`
- TypeScript: <https://skmtc.dev/recurrente/apis/referencia-api/docs/connected_accounts/:connected_account_id/tax_invoicing/put.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `connected_account_id` string, required

## Request body `multipart/form-data`

- object
  - `registration_type` 'managed', required: En v1 solo se permite facturación administrada por Recurrente
  - `activation_type` 'automatic' | 'manual', required: `automatic` descarga la firma desde SAT usando `sat_password`. `manual` usa el archivo PFX enviado en `firma_electronica`.
  - `sat_password` string: Requerido cuando `activation_type` es `automatic`
  - `firma_electronica` string, binary: Archivo PFX requerido cuando `activation_type` es `manual`
  - `pfx_password` string: Contraseña del PFX requerida cuando `activation_type` es `manual`
  - `establishment` string: Código de establecimiento. Si se omite, Recurrente usa `1`.

## Response `200`

Estado actualizado de facturación electrónica

- ConnectedAccountTaxInvoicing
  - `provider` 'recurrente' | 'custom': Proveedor de facturación fiscal
  - `registration_type` 'managed' | 'user_provided': Tipo de registro de facturación electrónica
  - `activation_type` 'automatic' | 'manual': Flujo usado para activar facturación electrónica
  - `status` 'disabled' | 'pending_data' | 'ready_to_upload' | 'activating' | 'pending_fiscal_profile' | 'probe_pending' | 'activation_attention_required' | 'enabled' | 'failed': Estado público de la activación de facturación electrónica
  - `status_notice` string, nullable: Mensaje público sobre el estado actual
  - `enabled` boolean: Indica si la facturación fiscal está habilitada en la cuenta
  - `ready_to_invoice` boolean: Indica si la cuenta ya tiene credenciales y datos fiscales listos para emitir facturas
  - `missing_requirements` string[]: Requisitos públicos pendientes antes de poder emitir facturas
  - `establishment` string, nullable: Código de establecimiento usado para emitir facturas

## Other responses

- `400`: Parámetros incompletos o inválidos
- `404`: Cuenta conectada no encontrada

## Changes

- **2026-09-19** `33bad9197d59`: 2 breaking
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `400`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `400`
- **2026-09-17** `3d76463f9fd8`: 1 warning, 1 info
  - deleted the `header` request parameter `X-SECRET-KEY`
  - the endpoint scheme security `secretKey` was added to the API
- **2026-09-12** `3f07af5cbba7`: 1 info
  - api operation id `update-connected-account-tax-invoicing` removed and replaced with `connectedAccounts_updateConnectedAccountTaxInvoicing`

[Operation history](https://skmtc.dev/recurrente/apis/referencia-api/changes/connected_accounts/:connected_account_id/tax_invoicing/put.md)

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) - [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurrente/apis/referencia-api/revisions/1a3fc480dd94?raw)