Saltar al contenido principal

Ambiente y URL base

URL base​

Toda petición al API Connect apunta a:

https://ocote.io/api/connect

Todas las rutas que encuentres en esta documentación son relativas a esa base. Por ejemplo, POST /invoice significa:

POST https://ocote.io/api/connect/invoice
Usa siempre HTTPS

El API rechaza peticiones en HTTP plano. Cualquier integración debe apuntar a https://.

Ambientes de MH: test y producción​

El API Connect no tiene dos hosts distintos para test y producción. El ambiente (test o producción real) lo determina cada empresa configurada en Ocote, no la URL.

  • Una empresa configurada como ambiente 00 (test) emite documentos de prueba que no tienen validez fiscal pero sí sello del MH de ambiente de test.
  • Una empresa configurada como ambiente 01 (producción) emite documentos reales con validez fiscal.

Cuando generas tu API key desde el panel de Ocote, la key queda amarrada a una empresa. Esa empresa ya trae definido su ambiente. Es decir: tu API key ya sabe si emite test o producción, y no hay forma de cruzarlos por accidente.

Para la fase de desarrollo e integración, pide una API key sobre una empresa en ambiente test. Para salir a producción, reemplaza la key por una de una empresa en ambiente 01 y no cambies nada más del código.

Distinguir test de producción desde tu lado​

Cuando emites un DTE, el control_number devuelto contiene el ambiente embebido:

  • DTE-01-M001P001-000000000000123 emitido en test → su JSON firmado y el sello MH incluyen ambiente: "00".
  • El mismo documento en producción → ambiente: "01".

Si necesitas bloquear en tu propio código la emisión accidental a producción, inspecciona el JSON descargado con GET /file/{id}?type=json&key=… y valida el campo identificacion.ambiente.

Qué se genera por defecto​

Cada vez que emites un DTE vía API, Ocote genera automáticamente y sin costo adicional:

  • JSON firmado (JWS) con el sello del MH, disponible para descarga.
  • Ticket PDF tipo 8x21 cm para documentos tipo 01 (Factura) — útil para impresoras térmicas.
  • Archivo del documento en el archivo histórico de la empresa, consultable desde la plataforma Ocote DTE.
  • Envío automático por correo al receptor si la empresa tiene configurada la plantilla SMTP (opcional).

No necesitas llamar endpoints adicionales para que estos archivos existan. Solo los descargas cuando los necesites. Ver Descargar archivos.

Datos de contacto y soporte​

Para obtener una API key, habilitar una empresa en ambiente de producción o reportar un problema del API, contacta directamente a Ocote Software.