FH Gotham ECF · Developers

UNA API · TU SISTEMA

De tu factura al resultado.

Conecta tu aplicación, valida el formato en Sandbox y conserva cada respuesta. Credenciales separadas por empresa y ambiente.

01

Obtén tu acceso

Solicita el usuario y token de tu empresa para Sandbox. Guarda el token en el servidor. La contraseña del portal no es un token API.

02

Prueba tu formato

Carga JSON o XML, revisa la validación y simula la firma. Descarga XML, PDF y el expediente. Sandbox nunca es una aceptación de DGII.

03

Prepara la salida real

Certificación y Producción tienen habilitaciones propias. Coordina la instalación del conector aprobado; cambiar el token por sí solo no habilita el envío productivo.

Conexión y ambientes

Authorization: Bearer <TOKEN_DEL_AMBIENTE>

Alternativa: HTTP Basic con usuario API y token como contraseña, siempre por HTTPS. La empresa se obtiene de la credencial, no de un company_id elegido en la factura.

Base URLUso
https://gotham.felizhosting.net/api/sandbox/v1Validación y simulación local; sin envío DGII.
https://gotham.felizhosting.net/api/certification/v1Pruebas DGII autorizadas; certificado y ejecución vigentes.
https://gotham.felizhosting.net/api/production/v1Consulta con acceso productivo. El envío genérico está bloqueado (409); se requiere conector aprobado.

SANDBOX · E31

Elige tu lenguaje

Los ejemplos usan datos ficticios para tu empresa, validan el JSON y generan una simulación. Define GOTHAM_SANDBOX_TOKEN y GOTHAM_IDEMPOTENCY_KEY (12–100 caracteres) de forma privada. No guardes secretos en código ni en el navegador.

Cargando ejemplos…

La plantilla inicial usa E310000000001. Conserva tu JSON para repetir exactamente la misma solicitud. Para una segunda factura Sandbox usa otro e-NCF de prueba y otra Idempotency-Key; nunca uses números productivos en estos ejemplos.

Datos y resultados claros

Reintentos sin duplicados

Reutiliza Idempotency-Key y los mismos bytes al recuperar una creación. Ante 409, revisa el conflicto; ante 422, corrige los datos. Ante 429, espera Retry-After. Ante 502/503 o un timeout de envío, consulta el documento existente: no generes otro número ni reenvíes a ciegas. El límite general autenticado es 120 solicitudes/minuto por empresa y ambiente; algunos planes aplican límites adicionales.

Seguridad en la integración

Usa HTTPS y credenciales separadas por empresa/ambiente. Ejecuta las llamadas desde tu servidor, restringe quién ve los tokens, redáctalos en los logs y rótalos si se exponen. No incluyas P12, contraseñas ni cédulas en muestras JSON. Sube certificados solo mediante el formulario privado autorizado. Ningún sistema es invulnerable: valida tu integración y conserva un procedimiento de revocación y conciliación.