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.
UNA API · TU SISTEMA
Conecta tu aplicación, valida el formato en Sandbox y conserva cada respuesta. Credenciales separadas por empresa y ambiente.
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.
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.
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.
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 URL | Uso |
|---|---|
https://gotham.felizhosting.net/api/sandbox/v1 | Validación y simulación local; sin envío DGII. |
https://gotham.felizhosting.net/api/certification/v1 | Pruebas DGII autorizadas; certificado y ejecución vigentes. |
https://gotham.felizhosting.net/api/production/v1 | Consulta con acceso productivo. El envío genérico está bloqueado (409); se requiere conector aprobado. |
SANDBOX · E31
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.
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.
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.