Ir al contenido
GOTHAM ECF · API

Tu sistema. Tus facturas. Una conexión.

Integra tu aplicación con Gotham ECF, valida tus comprobantes y consulta sus resultados. Empieza en Sandbox con credenciales de tu empresa.

Ejemplos en Python, JavaScript, PHP, cURL, C#, Java y Go.

Conecta en tres etapas

01

Prepara el acceso

Solicita usuario y token Sandbox de la empresa. El token se usa desde tu servidor; la contraseña del portal es independiente.

02

Valida una muestra

Envía JSON o XML con los datos fiscales y el e-NCF de prueba. Revisa errores, simula el envío y descarga XML, PDF y respuestas.

03

Revisa y habilita

Coordina la instalación del conector aprobado y revisa los requisitos de Certificación o Producción. Cambiar el token por sí solo no habilita la emisión real.

Ambientes separados, resultados verificables

https://gotham.felizhosting.net/api/sandbox/v1

Sandbox valida y simula sin enviar a DGII ni consumir numeración productiva. Certificación usa pruebas autorizadas. Producción requiere revisión, certificado y conector habilitado; el envío genérico de la API pública permanece bloqueado.

Un HTTP 200 o un TrackId no prueba aceptación. Conserva el documento, la respuesta DGII, el XML firmado y el PDF. Consulta el estado del mismo documento antes de reintentar un envío.

Buenas prácticas desde la primera llamada

  • HTTPS y token exclusivo por empresa y ambiente. Nunca lo incluyas en enlaces, código público o aplicaciones del navegador.
  • Idempotency-Key estable: conserva la clave y los mismos bytes al recuperar una creación; así evitas duplicados.
  • Límite general: 120 solicitudes por minuto por empresa y ambiente. Ante 429, espera Retry-After; no consultes en un bucle continuo.
  • El certificado .p12 y su contraseña se cargan en el formulario privado autorizado, nunca en muestras JSON ni en esta página.
  • Antes de producción, verifica totales, identificación, tipos de comprobante, secuencias, permisos y recuperación de errores.