Autenticación
FiscalAPI autentica cada solicitud HTTP con dos datos: el tenant, que identifica tu cuenta, y la API key, que autoriza la solicitud. Esta guía explica cómo enviarlos.
Encabezados HTTP requeridos
Incluye estos dos encabezados en todas las peticiones a la API:
| Encabezado | Valor |
|---|---|
X-TENANT-KEY | Identificador único de tu cuenta en FiscalAPI (tenant). |
X-API-KEY | API key que autentica la solicitud. |
Las solicitudes que crean facturas o tickets, o que transfieren o retiran timbres, aceptan además el encabezado opcional Idempotency-Key, para reintentar sin duplicar la operación. Consulta Solicitudes idempotentes.
Una API key sigue activa hasta que la revocas en el dashboard. Si sospechas que alguna de tus API keys se filtró, revócala de inmediato para proteger tus recursos.
Autenticar peticiones con la API key y el tenant
Para acceder a un recurso protegido, envía tu API key y tu tenant en los encabezados anteriores. Este ejemplo crea una factura de ingreso con Crear factura ingreso (POST /api/v4/invoices).
Request
curl --location 'https://test.fiscalapi.com/api/v4/invoices' \
--header 'X-TENANT-KEY: <my-tenant>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <my-api-key>' \
--data '{
"versionCode": "4.0",
"series": "F",
"date": "2025-04-17T08:56:40",
"paymentFormCode": "01",
"paymentMethodCode": "PUE",
"currencyCode": "MXN",
"typeCode": "I",
"expeditionZipCode": "42501",
"exchangeRate": 1,
"exportCode": "01",
"issuer": {
"id": "78d380fd-1b69-4e3c-8bc0-4f57737f7d5f"
},
"recipient": {
"id": "bef56254-0892-4558-95c3-f9c8729e4b0e"
},
"items": [
{
"id": "310301b3-1ae9-441b-b463-51a8f9ca8ba2",
"quantity": 9.5,
"discount": 25.85
}
]
}'
Uso de los SDK
Los SDK oficiales (.NET, Node.js, Python, PHP y Java) envían los encabezados de autenticación por ti: configura el tenant y la API key una sola vez, al crear el cliente, como en los ejemplos anteriores.