Docs

Inicio rápido

Crea tu primera integración

Configura una API key de prueba, haz tu primera solicitud y sigue los flujos REST y MCP.

Producción y entorno de prueba

Las API keys de organización pertenecen a un solo entorno. Las claves de prueba usan las operaciones marcadas “Producción y prueba” en la referencia de API contra datos de prueba aislados. Las operaciones exclusivas de producción, y las herramientas que dependen de ellas, no están disponibles en prueba; el sandbox tiene su propio servidor MCP. Las credenciales se rechazan fuera del entorno asignado y el error indica la dirección correcta. Límites, operaciones disponibles y pruebas de reintentos: Sandbox y pruebas

Haz tu primera solicitud autenticada

Comienza con una organización de prueba aislada y una API key de prueba.

Abre la consola para desarrolladores

Abre /consola desde Exac, selecciona Prueba y entra a Claves API para tu workspace actual.

Crea una API key de prueba

Crea una clave para Prueba y cópiala una sola vez. Exac prepara el entorno aislado automáticamente.

Verifica la organización de prueba

Llama GET /v1/organization con la clave de prueba contra el servidor de prueba mostrado en OpenAPI.

Ejecuta un flujo Test

Crea un contacto y un borrador CFDI; luego crea, consulta y cancela un timbrado de prueba. Los artefactos de sandbox no se envían al SAT y no tienen validez fiscal.

curl "https://api.sandbox.exac.mx/v1/organization" \  --header "Authorization: Bearer <EXAC_API_KEY>"

Tu primera escritura

Cada escritura requiere Idempotency-Key. Genera una clave por operación y reutilízala en cada reintento: tras un timeout o un error 429 o 5xx, repetir la misma solicitud devuelve el resultado original en lugar de duplicar el efecto.

curl -X POST "https://api.sandbox.exac.mx/v1/contacts" \  -H "Authorization: Bearer <EXAC_API_KEY>" \  -H "Idempotency-Key: sandbox-create-contact" \  -H "Content-Type: application/json" \  -d '{    "kind": "customer",    "legalName": "Estudio Jacaranda",    "email": "administracion@jacaranda.example",    "rfc": "AAA010101AAA",    "taxSystem": "601",    "cfdiUse": "G03",    "address": {      "postalCode": "82110",      "country": "MEX"    }  }'

Convenciones de solicitudes, respuestas y reintentos

Envía Authorization: Bearer <credencial> en cada solicitud de API y Content-Type: application/json cuando envíes un cuerpo JSON. Los éxitos JSON usan { data }; las respuestas paginadas también incluyen pagination. Las fallas usan { error: { code, message, status, details? } }. Decide con error.code, no con el mensaje humano. Las descargas devuelven bytes en lugar de un sobre JSON.

Al crear una API key de organización eliges su nivel de acceso con accessLevel: full (predeterminado) o read. Una clave read puede llamar a todas las operaciones REST y herramientas MCP que solo leen datos, y recibe 403 en cualquier otra, incluida la administración de claves API. No hay permisos personalizados por operación.

Flujos canónicos

Usa la misma intención de dominio mediante REST o MCP. Estos ejemplos se validan contra los contratos de ejecución; reemplaza los identificadores y credenciales de ejemplo con valores de tu organización.