---
title: "Sandbox y pruebas"
description: "Ejecuta el ciclo completo de un CFDI con datos de prueba aislados y ensaya reintentos y rechazos de timbrado antes de pasar a producción."
language: es-MX
canonical_url: "https://exac.mx/docs/sandbox"
md_url: "https://exac.mx/docs/sandbox.md"
---

# Sandbox y pruebas

Ejecuta el ciclo completo de un CFDI con datos de prueba aislados y ensaya reintentos y rechazos de timbrado antes de pasar a producción.

## Qué es el sandbox

El sandbox es un despliegue independiente del mismo contrato REST. Nada de lo que hagas ahí toca datos de producción y nada de lo que genera se envía al SAT.

- **URL base:** `https://api.sandbox.exac.mx`. Producción usa otro origen; consulta los servidores en la referencia de la API.

- **Credenciales:** API keys de organización creadas para el entorno de prueba, que incluyen el permiso api:sandbox. No se aceptan tokens de acceso OAuth. Producción rechaza una clave de sandbox y el sandbox rechaza una clave de producción.

- **Documentos:** Exac simula el timbrado sin llamar al SAT, no se pueden verificar ahí y no tienen validez fiscal.

- **Datos:** La organización de prueba, sus contactos, borradores y documentos están aislados de tu organización de producción. La certificación en sandbox es gratuita.

## Operaciones disponibles en sandbox

Solo las operaciones siguientes existen en el servidor de prueba. La lista se genera desde el mismo contrato de operaciones que usan el runtime y el documento OpenAPI, así que cambia cuando cambia el contrato.

Las operaciones que no aparecen son solo de producción y no existen en el servidor de prueba.

### Organización

- [Obtener organización](/docs/api/workspace/organization/get-organization): `GET /v1/organization`. Idempotency-Key: No requerida.

### Emisores

- [Listar emisores](/docs/api/workspace/issuers/list-issuers): `GET /v1/issuers`. Idempotency-Key: No requerida.

- [Crear emisor](/docs/api/workspace/issuers/create-issuer): `POST /v1/issuers`. Idempotency-Key: Requerida.

- [Obtener emisor](/docs/api/workspace/issuers/get-issuer): `GET /v1/issuers/{rfc}`. Idempotency-Key: No requerida.

- [Eliminar emisor](/docs/api/workspace/issuers/delete-issuer): `DELETE /v1/issuers/{rfc}`. Idempotency-Key: Requerida.

### Credenciales

- [Listar endpoints de webhooks](/docs/api/workspace/credentials/list-webhook-endpoints): `GET /v1/organization/webhook-endpoints`. Idempotency-Key: No requerida.

- [Crear endpoint de webhooks](/docs/api/workspace/credentials/create-webhook-endpoint): `POST /v1/organization/webhook-endpoints`. Idempotency-Key: Requerida.

- [Consultar endpoint de webhooks](/docs/api/workspace/credentials/get-webhook-endpoint): `GET /v1/organization/webhook-endpoints/{endpointId}`. Idempotency-Key: No requerida.

- [Actualizar endpoint de webhooks](/docs/api/workspace/credentials/update-webhook-endpoint): `PATCH /v1/organization/webhook-endpoints/{endpointId}`. Idempotency-Key: Requerida.

- [Eliminar endpoint de webhooks](/docs/api/workspace/credentials/delete-webhook-endpoint): `DELETE /v1/organization/webhook-endpoints/{endpointId}`. Idempotency-Key: Requerida.

- [Rotar secreto de firma del webhook](/docs/api/workspace/credentials/rotate-webhook-endpoint-secret): `POST /v1/organization/webhook-endpoints/{endpointId}/rotate-secret`. Idempotency-Key: Requerida.

- [Listar entregas de webhooks](/docs/api/workspace/credentials/list-webhook-deliveries): `GET /v1/organization/webhook-endpoints/{endpointId}/deliveries`. Idempotency-Key: No requerida.

- [Reenviar entrega de webhook](/docs/api/workspace/credentials/replay-webhook-delivery): `POST /v1/organization/webhook-endpoints/{endpointId}/deliveries/{deliveryId}/replay`. Idempotency-Key: Requerida.

- [Enviar evento de webhook de prueba](/docs/api/workspace/credentials/test-webhook-endpoint): `POST /v1/organization/webhook-endpoints/{endpointId}/test`. Idempotency-Key: Requerida.

### Developer activity

- [Listar solicitudes programáticas](/docs/api/workspace/developer-activity/list-programmatic-requests): `GET /v1/organization/activity`. Idempotency-Key: No requerida.

- [Obtener solicitud programática](/docs/api/workspace/developer-activity/get-programmatic-request): `GET /v1/organization/activity/{requestId}`. Idempotency-Key: No requerida.

### Configuración fiscal

- [Cargar certificado](/docs/api/workspace/fiscal-setup/upload-certificate): `PUT /v1/organization/certificates/{kind}`. Idempotency-Key: Requerida. kind: `csd`.

- [Eliminar certificado](/docs/api/workspace/fiscal-setup/delete-certificate): `DELETE /v1/organization/certificates/{kind}`. Idempotency-Key: Requerida. kind: `csd`.

### Contactos

- [Listar contactos](/docs/api/catalog/contacts/list-contacts): `GET /v1/contacts`. Idempotency-Key: No requerida.

- [Obtener contacto](/docs/api/catalog/contacts/get-contact): `GET /v1/contacts/{contactId}`. Idempotency-Key: No requerida.

- [Crear contacto](/docs/api/catalog/contacts/create-contact): `POST /v1/contacts`. Idempotency-Key: Requerida.

- [Actualizar contacto](/docs/api/catalog/contacts/update-contact): `PATCH /v1/contacts/{contactId}`. Idempotency-Key: Requerida.

- [Eliminar contacto](/docs/api/catalog/contacts/delete-contact): `DELETE /v1/contacts/{contactId}`. Idempotency-Key: Requerida.

### SAT

- [Buscar productos SAT](/docs/api/catalog/sat/search-sat-product-catalog): `GET /v1/reference/sat-products`. Idempotency-Key: No requerida.

### Productos

- [Listar productos](/docs/api/catalog/products/list-products): `GET /v1/products`. Idempotency-Key: No requerida.

- [Obtener producto](/docs/api/catalog/products/get-product): `GET /v1/products/{productId}`. Idempotency-Key: No requerida.

- [Crear producto](/docs/api/catalog/products/create-product): `POST /v1/products`. Idempotency-Key: Requerida.

- [Actualizar producto](/docs/api/catalog/products/update-product): `PATCH /v1/products/{productId}`. Idempotency-Key: Requerida.

- [Eliminar producto](/docs/api/catalog/products/delete-product): `DELETE /v1/products/{productId}`. Idempotency-Key: Requerida.

- [Listar movimientos de inventario](/docs/api/catalog/products/list-inventory-movements): `GET /v1/inventory-movements`. Idempotency-Key: No requerida.

- [Listar operaciones de inventario](/docs/api/catalog/products/list-inventory-movement-operations): `GET /v1/inventory-movement-operations`. Idempotency-Key: No requerida.

- [Listar movimientos de la operación](/docs/api/catalog/products/list-inventory-operation-movements): `GET /v1/inventory-movement-operations/{operationId}/movements`. Idempotency-Key: No requerida.

- [Listar existencias por sucursal](/docs/api/catalog/products/list-product-inventory-levels): `GET /v1/products/{productId}/inventory-levels`. Idempotency-Key: No requerida.

- [Listar proveedores del producto](/docs/api/catalog/products/list-product-suppliers): `GET /v1/products/{productId}/suppliers`. Idempotency-Key: No requerida.

- [Actualizar inventario](/docs/api/catalog/products/update-product-inventory): `POST /v1/products/{productId}/inventory`. Idempotency-Key: Requerida.

- [Registrar entrada de proveedor](/docs/api/catalog/products/create-inventory-receipt): `POST /v1/inventory-receipts`. Idempotency-Key: Requerida.

### Empleados

- [Listar empleados](/docs/api/catalog/employees/list-employees): `GET /v1/employees`. Idempotency-Key: No requerida.

- [Obtener empleado](/docs/api/catalog/employees/get-employee): `GET /v1/employees/{employeeId}`. Idempotency-Key: No requerida.

- [Crear empleado](/docs/api/catalog/employees/create-employee): `POST /v1/employees`. Idempotency-Key: Requerida.

- [Actualizar empleado](/docs/api/catalog/employees/update-employee): `PATCH /v1/employees/{employeeId}`. Idempotency-Key: Requerida.

- [Eliminar empleado](/docs/api/catalog/employees/delete-employee): `DELETE /v1/employees/{employeeId}`. Idempotency-Key: Requerida.

### Sucursales

- [Listar sucursales](/docs/api/catalog/locations/list-locations): `GET /v1/settings/locations`. Idempotency-Key: No requerida.

- [Obtener sucursal](/docs/api/catalog/locations/get-location): `GET /v1/settings/locations/{locationId}`. Idempotency-Key: No requerida.

- [Crear sucursal](/docs/api/catalog/locations/create-location): `POST /v1/settings/locations`. Idempotency-Key: Requerida.

- [Actualizar sucursal](/docs/api/catalog/locations/update-location): `PATCH /v1/settings/locations/{locationId}`. Idempotency-Key: Requerida.

- [Eliminar sucursal](/docs/api/catalog/locations/delete-location): `DELETE /v1/settings/locations/{locationId}`. Idempotency-Key: Requerida.

### Configuración

- [Listar campos de recibo de venta](/docs/api/catalog/settings/list-sales-receipt-fields): `GET /v1/settings/receipt-fields`. Idempotency-Key: No requerida.

- [Obtener campo de recibo de venta](/docs/api/catalog/settings/get-sales-receipt-field): `GET /v1/settings/receipt-fields/{fieldId}`. Idempotency-Key: No requerida.

- [Crear campo de recibo de venta](/docs/api/catalog/settings/create-sales-receipt-field): `POST /v1/settings/receipt-fields`. Idempotency-Key: Requerida.

- [Actualizar campo de recibo de venta](/docs/api/catalog/settings/update-sales-receipt-field): `PATCH /v1/settings/receipt-fields/{fieldId}`. Idempotency-Key: Requerida.

- [Eliminar campo de recibo de venta](/docs/api/catalog/settings/delete-sales-receipt-field): `DELETE /v1/settings/receipt-fields/{fieldId}`. Idempotency-Key: Requerida.

- [Listar valores de campo de recibo](/docs/api/catalog/settings/list-sales-receipt-field-values): `GET /v1/settings/receipt-fields/{fieldId}/values`. Idempotency-Key: No requerida.

- [Obtener series fiscales](/docs/api/catalog/settings/get-fiscal-series): `GET /v1/settings/fiscal-series`. Idempotency-Key: No requerida.

- [Actualizar series fiscales](/docs/api/catalog/settings/update-fiscal-series): `PATCH /v1/settings/fiscal-series/{seriesId}`. Idempotency-Key: Requerida.

### Precios

- [Listar precios de cliente](/docs/api/catalog/pricing/list-customer-prices): `GET /v1/pricing/customers/{customerId}`. Idempotency-Key: No requerida.

- [Definir precio de cliente](/docs/api/catalog/pricing/set-customer-price): `PUT /v1/pricing/customers/{customerId}/products/{productId}`. Idempotency-Key: Requerida.

- [Eliminar precio de cliente](/docs/api/catalog/pricing/delete-customer-price): `DELETE /v1/pricing/customers/{customerId}/products/{productId}`. Idempotency-Key: Requerida.

- [Listar precios de sucursal](/docs/api/catalog/pricing/list-location-prices): `GET /v1/pricing/locations/{locationId}`. Idempotency-Key: No requerida.

- [Definir precio de sucursal](/docs/api/catalog/pricing/set-location-price): `PUT /v1/pricing/locations/{locationId}/products/{productId}`. Idempotency-Key: Requerida.

- [Eliminar precio de sucursal](/docs/api/catalog/pricing/delete-location-price): `DELETE /v1/pricing/locations/{locationId}/products/{productId}`. Idempotency-Key: Requerida.

### Facturas

- [Listar facturas](/docs/api/documents/invoices/list-invoices): `GET /v1/invoices`. Idempotency-Key: No requerida.

- [Obtener factura](/docs/api/documents/invoices/get-invoice): `GET /v1/invoices/{documentRef}`. Idempotency-Key: No requerida.

- [Crear borrador de factura](/docs/api/documents/invoices/create-invoice-draft): `POST /v1/invoices`. Idempotency-Key: Requerida.

- [Crear borrador de factura desde recibos de venta](/docs/api/documents/invoices/create-invoice-draft-from-sales-receipts): `POST /v1/invoices/from-sales-receipts`. Idempotency-Key: Requerida.

- [Actualizar borrador de factura](/docs/api/documents/invoices/update-invoice-draft): `PUT /v1/invoices/{documentRef}`. Idempotency-Key: Requerida.

- [Timbrar factura](/docs/api/documents/invoices/stamp-invoice): `POST /v1/invoices/{documentRef}/stamp`. Idempotency-Key: Requerida.

- [Cancelar factura](/docs/api/documents/invoices/cancel-invoice): `POST /v1/invoices/{documentRef}/cancel`. Idempotency-Key: Requerida.

- [Archivar factura](/docs/api/documents/invoices/archive-invoice): `PUT /v1/invoices/{documentRef}/archive`. Idempotency-Key: Requerida.

### Documentos de retención

- [Listar retenciones](/docs/api/documents/withholding-documents/list-withholdings): `GET /v1/withholdings`. Idempotency-Key: No requerida.

- [Obtener retención](/docs/api/documents/withholding-documents/get-withholding): `GET /v1/withholdings/{documentRef}`. Idempotency-Key: No requerida.

- [Cancelar documento de retención](/docs/api/documents/withholding-documents/cancel-withholding): `POST /v1/withholdings/{documentRef}/cancel`. Idempotency-Key: Requerida.

- [Archivar documento de retención](/docs/api/documents/withholding-documents/archive-withholding): `PUT /v1/withholdings/{documentRef}/archive`. Idempotency-Key: Requerida.

- [Crear retención](/docs/api/documents/withholding-documents/create-withholding): `POST /v1/withholdings`. Idempotency-Key: Requerida.

### Recibos de venta

- [Listar recibos de venta](/docs/api/documents/sales-receipts/list-sales-receipts): `GET /v1/sales-receipts`. Idempotency-Key: No requerida.

- [Obtener recibo de venta](/docs/api/documents/sales-receipts/get-sales-receipt): `GET /v1/sales-receipts/{documentRef}`. Idempotency-Key: No requerida.

- [Listar reembolsos de recibos](/docs/api/documents/sales-receipts/list-sales-receipt-refunds): `GET /v1/sales-receipt-refunds`. Idempotency-Key: No requerida.

- [Obtener reembolso de recibo](/docs/api/documents/sales-receipts/get-sales-receipt-refund): `GET /v1/sales-receipt-refunds/{documentRef}`. Idempotency-Key: No requerida.

- [Crear recibo de venta](/docs/api/documents/sales-receipts/create-sales-receipt): `POST /v1/sales-receipts`. Idempotency-Key: Requerida.

- [Cancelar recibo de venta](/docs/api/documents/sales-receipts/cancel-sales-receipt): `POST /v1/sales-receipts/{documentRef}/cancel`. Idempotency-Key: Requerida.

- [Reembolsar recibo de venta](/docs/api/documents/sales-receipts/create-sales-receipt-refund): `POST /v1/sales-receipts/{documentRef}/refunds`. Idempotency-Key: Requerida.

### Archivos y entrega

- [Descargar archivo](/docs/api/documents/files-and-delivery/download-document-file): `GET /v1/documents/{documentRef}/files/{file}`. Idempotency-Key: No requerida. Categorías de documento en prueba: `invoice`, `withholding`, `sales_receipt`.

### Nómina

- [Obtener ajustes de nómina](/docs/api/documents/payroll/get-payroll-settings): `GET /v1/payroll/settings`. Idempotency-Key: No requerida.

- [Actualizar ajustes de nómina](/docs/api/documents/payroll/update-payroll-settings): `PUT /v1/payroll/settings`. Idempotency-Key: Requerida.

- [Listar nóminas](/docs/api/documents/payroll/list-payroll-runs): `GET /v1/payroll/runs`. Idempotency-Key: No requerida.

- [Preparar nómina](/docs/api/documents/payroll/prepare-payroll-run): `POST /v1/payroll/runs`. Idempotency-Key: Requerida.

- [Obtener nómina](/docs/api/documents/payroll/get-payroll-run): `GET /v1/payroll/runs/{runId}`. Idempotency-Key: No requerida.

- [Cambiar fecha de pago de la nómina](/docs/api/documents/payroll/update-payroll-run): `PATCH /v1/payroll/runs/{runId}`. Idempotency-Key: Requerida.

- [Recalcular nómina](/docs/api/documents/payroll/recalculate-payroll-run): `POST /v1/payroll/runs/{runId}/recalculate`. Idempotency-Key: Requerida.

- [Timbrar recibos de nómina](/docs/api/documents/payroll/stamp-payroll-run): `POST /v1/payroll/runs/{runId}/stamp`. Idempotency-Key: Requerida.

- [Descartar nómina](/docs/api/documents/payroll/discard-payroll-run): `DELETE /v1/payroll/runs/{runId}`. Idempotency-Key: Requerida.

- [Listar recibos de nómina](/docs/api/documents/payroll/list-payroll-rows): `GET /v1/payroll/runs/{runId}/rows`. Idempotency-Key: No requerida.

- [Obtener recibo de nómina](/docs/api/documents/payroll/get-payroll-row): `GET /v1/payroll/rows/{rowId}`. Idempotency-Key: No requerida.

- [Actualizar recibo de nómina](/docs/api/documents/payroll/update-payroll-row): `PATCH /v1/payroll/rows/{rowId}`. Idempotency-Key: Requerida.

- [Preparar de nuevo un recibo cancelado](/docs/api/documents/payroll/prepare-payroll-row-again): `POST /v1/payroll/rows/{rowId}/prepare-again`. Idempotency-Key: Requerida.

- [Volver a timbrar un recibo rechazado](/docs/api/documents/payroll/restamp-payroll-row): `POST /v1/payroll/rows/{rowId}/restamp`. Idempotency-Key: Requerida.

### Cuentas

- [Listar cuentas por cobrar](/docs/api/accounts-payments/accounts/list-receivable-accounts): `GET /v1/accounts/receivables`. Idempotency-Key: No requerida.

- [Obtener cuenta por cobrar](/docs/api/accounts-payments/accounts/get-receivable-account): `GET /v1/accounts/receivables/{customerId}`. Idempotency-Key: No requerida.

- [Archivar o restaurar factura por cobrar](/docs/api/accounts-payments/accounts/set-receivable-archived): `POST /v1/accounts/receivables/{customerId}/invoices/{documentRef}/archive`. Idempotency-Key: Requerida.

- [Planificar cobros de factura emitida](/docs/api/accounts-payments/accounts/set-receivable-payment-plan): `PUT /v1/accounts/receivables/{customerId}/invoices/{documentRef}/plan`. Idempotency-Key: Requerida.

- [Listar cuentas por pagar](/docs/api/accounts-payments/accounts/list-payable-accounts): `GET /v1/accounts/payables`. Idempotency-Key: No requerida.

- [Obtener cuenta por pagar](/docs/api/accounts-payments/accounts/get-payable-account): `GET /v1/accounts/payables/{supplierId}`. Idempotency-Key: No requerida.

- [Archivar o restaurar factura por pagar](/docs/api/accounts-payments/accounts/set-payable-archived): `POST /v1/accounts/payables/{supplierId}/invoices/{documentRef}/archive`. Idempotency-Key: Requerida.

- [Planificar pagos de factura recibida](/docs/api/accounts-payments/accounts/set-payable-payment-plan): `PUT /v1/accounts/payables/{supplierId}/invoices/{documentRef}/plan`. Idempotency-Key: Requerida.

### Reportes

- [Obtener reporte de ingresos y gastos](/docs/api/tax-reports/reports/get-income-expenses-report): `GET /v1/reports/income-expenses`. Idempotency-Key: No requerida.

- [Obtener reporte de ventas](/docs/api/tax-reports/reports/get-sales-report): `GET /v1/reports/sales`. Idempotency-Key: No requerida.

- [Obtener reporte de facturación](/docs/api/tax-reports/reports/get-invoicing-report): `GET /v1/reports/invoicing`. Idempotency-Key: No requerida.

- [Obtener reporte de nómina](/docs/api/tax-reports/reports/get-payroll-report): `GET /v1/reports/payroll`. Idempotency-Key: No requerida.

## Ejecuta el ciclo completo de un CFDI

El flujo del ciclo de un CFDI en sandbox crea un cliente y un borrador, lo timbra, descarga el PDF y lo cancela. Sus cuerpos de solicitud y la guía de reintentos de cada paso están en los flujos del Inicio rápido.

1. Verifica la organización: `GET /v1/organization`

2. Crea un cliente de prueba: `POST /v1/contacts`

3. Crea un borrador CFDI: `POST /v1/invoices`

4. Crea un timbrado de prueba: `POST /v1/invoices/invoice:invoice-example/stamp`

5. Descarga el PDF de prueba: `GET /v1/documents/invoice:invoice-example/files/pdf`

6. Cancela el CFDI de prueba: `POST /v1/invoices/invoice:invoice-example/cancel`

[Abrir el flujo del ciclo en sandbox](/docs/quickstart#sandbox-cfdi-lifecycle)

## Prueba reintentos y fallas

Toda escritura requiere Idempotency-Key. Ensaya estos casos con la operación de timbrado antes de depender de ellos en producción.

### Repetición idempotente

Las claves se conservan 7 días y se limitan a la organización y a la identidad que llama. Para simular un timeout, envía la solicitud de timbrado, corta la conexión antes de leer la respuesta y repite la solicitud idéntica.

- La misma clave, ruta y cuerpo otra vez: Se repite el resultado original y el documento no se timbra por segunda vez. Confírmalo leyendo el documento.

- La misma clave con otro cuerpo u otra operación: `idempotency_conflict`. La solicitud se rechaza. Usa una clave nueva para una solicitud modificada.

- La misma clave mientras el primer intento sigue en curso: `operation_in_progress`. Espera el encabezado Retry-After y repite la solicitud exacta.

- La misma clave después de 7 días: Ya no hay deduplicación. Lee el documento antes de enviar otra escritura.

### Simula un rechazo de timbrado

El sandbox reserva valores que se timbran como el rechazo del SAT que daría producción. No pueden pertenecer a un contribuyente real. La ruta reportada indica dónde apunta el error, no es un campo del cuerpo del borrador: un borrador no acepta un objeto issuer ni receiver. Guarda el valor en el registro del que se construye el borrador, crea el borrador a partir de ese registro y llama a la operación de timbrado.

- `CFDI40139`: Valor reservado `RAZON SOCIAL NO REGISTRADA`. Dónde ponerlo: La razón social del emisor: legalName en POST /v1/issuers. Crea el emisor, sube su CSD y timbra con el encabezado Exac-Issuer. Se reporta en: `issuer.legalName`. Cómo corregirlo: La API no permite renombrar un emisor. Elimínalo con DELETE /v1/issuers/{rfc} y créalo de nuevo con la razón social real.

- `CFDI40148`: Valor reservado `00148`. Dónde ponerlo: El address.postalCode del contacto cliente, con address.country MEX, en POST /v1/contacts. Crea el borrador con ese customerId. Se reporta en: `receiver.postalCode`. Cómo corregirlo: Haz PATCH /v1/contacts/{contactId} con un código postal real, reemplaza el borrador con PUT /v1/invoices/{documentRef} para que lea de nuevo el contacto y timbra.

- `NOM9`: Valor reservado `XNOM010101009`. Dónde ponerlo: El rfc del empleado en POST /v1/employees. Prepara una nómina que incluya al empleado y timbra con POST /v1/payroll/runs/{runId}/stamp. Se reporta en: `employee.rfc`. Cómo corregirlo: El RFC de un empleado no se puede cambiar: PATCH /v1/employees/{employeeId} rechaza rfc como clave no reconocida. Crea un empleado de reemplazo con POST /v1/employees y el RFC real, omite el recibo rechazado con PATCH /v1/payroll/rows/{rowId} y excluded true, recalcula la nómina con POST /v1/payroll/runs/{runId}/recalculate y vuelve a timbrarla con el expectedCount y el expectedNet que leas en la nómina. Cada una es una solicitud nueva con un Idempotency-Key nuevo.

Un timbrado de CFDI rechazado devuelve validation_error (HTTP 400) con details.retryable = false y el código del SAT en details.issues[].code. El borrador queda sin timbrar.

Un recibo de nómina rechazado no hace fallar la solicitud: se lee con state rejected y rejectionCode con el código del SAT.

Un rechazo síncrono de CFDI no completa la operación, así que después de corregir el registro de origen y el borrador puedes repetir la solicitud de timbrado con la misma clave. La nómina es distinta: timbrar una nómina o volver a timbrar un recibo completa su operación idempotente en cuanto el trabajo queda en cola, así que repetir la misma clave devuelve el resultado guardado y no timbra nada. Recupera un recibo rechazado con las operaciones separadas de la tabla, cada una con un Idempotency-Key nuevo.

### Después de un resultado incierto

Si un timbrado termina con recovery_required, no reintentes automáticamente ni cambies la clave. Lee el documento con la operación de consulta de factura, usando details.document.documentRef del error cuando exista, y revisa su estado.

La operación para refrescar el estado es solo de producción. En sandbox, la lectura del documento es la forma de verificar el resultado.

### Lo que el sandbox no simula

No hay un interruptor para forzar provider_unavailable, un timeout u otra falla transitoria. Ensaya esas rutas con la repetición tras cortar la conexión y con los valores de rechazo reservados.

## MCP en sandbox

El sandbox tiene su propio servidor MCP, con las mismas herramientas salvo las exclusivas de producción. Solo acepta claves de API de sandbox. Crea un borrador, timbralo y cancélalo por MCP igual que por REST; los timbrados se simulan. [Servidor MCP](/docs/mcp)

## Antes de pasar a producción

- Cambia la URL base y reemplaza la API key de sandbox por una de producción.

- Ejecuta de punta a punta el ciclo, un timbrado repetido y cada caso de rechazo anterior.

- Guarda el Idempotency-Key y el documentRef de cada escritura, y decide según error.code, no según el mensaje.

- Atiende recovery_required leyendo el documento, nunca cambiando la clave.

- Fondea el monedero prepagado: la certificación en producción se cobra desde el primer timbre.

- Recuerda que las operaciones ausentes de la lista de sandbox, y las herramientas MCP marcadas solo producción, se prueban únicamente en producción.

Documentación completa: https://exac.mx/docs.md
Índice para agentes: https://exac.mx/docs/llms.txt
