API Rest
La API de Facturación Electrónica TTT es una solución RESTful diseñada para facilitar el proceso de emisión, cancelación y consulta de cualquier CFDI. Esta API está alineada con los requisitos del Servicio de Administración Tributaria (SAT) y permite a los desarrolladores integrar fácilmente funcionalidades de facturación en sus aplicaciones o desarrollos a la medida, en minutos, ofreciendo un panel para controlar, administrar y reportear toda la actividad de sus emisores.
Requisitos Previos a su Uso
Antes de utilizar la API, asegúrate de cumplir con los siguientes requisitos:
- Certificado de Sello Digital (CSD): Necesitarás generar este certificado a través del SAT lo cual te permite sellar los documentos CFDI, esta conformado con un archivo .CER, un archivo .KEY y una contraseña alfanumérica que se elige al momento de generar el CSD del contribuyente que emitirá los comprobantes. No te preocupes si estas haciendo pruebas ya que para eso existen certificados de pruebas que puedes descargar aquí.
- CLIENT ID: Deberás solicitar tu Identificador de cliente, será tu credencial que identifique tu cuenta dentro de la API, para eso ponte en contacto desde aquí.
- Ambiente de Pruebas: Sugerimos tener instalado el software Postman para realizar pruebas de conexión a la API usando los ejemplos proporcionados en los cuales te puedes basar para hacer tu integración.
- ¿Necesitas certificados (CSD) de prueba? Si usarás el ambiente de pruebas, será necesario emitir con un emisor de prueba, Descargalos aquí
Cómo Empezar tu Integración
- Token API: Consigue tu credencial para la conexión en **Token api** este Token te permite generar una conexión segura entre tu sesión y nuestra API.
- ¿Qué es un token de API?
- Un token de API es una cadena única de caracteres que se utiliza para autenticar solicitudes realizadas a una aplicación. Este token se envía en la cabecera de autorización (Authorization) de las peticiones HTTP. Actúa como una contraseña que el servidor puede verificar para asegurarse de que la solicitud proviene de una fuente confiable y autorizada.
- CLIENT ID: Consigue tu identificador de cliente, esta es una cadena única que idnetifica tus datos de cliente contra nuestra API Datos del cliente
- ¿Qué es un identificador de cliente?
- Un identificador de cliente es un identificador en formato UUID (Identificador Único Universal) que se utiliza para validar al cliente que realiza una solicitud. Este identificador ayuda a garantizar que las solicitudes se carguen al cliente correcto. En nuestras aplicaciones, este identificador se envía en una cabecera personalizada (X-CLIENT-ID) en las peticiones HTTP.
- Descarga los ejemplos de conexión a la api Descargar ejemplos (Sandbox)
- Dentro de la configuración de Postman, en la pestaña variables, deberás agregar las variables con los valores correspondientes a tu Token API y CLIENT ID previamente mencionados.
- Consulta la documentación de la API para obtener información sobre los endpoints disponibles y cómo utilizarlos. Ir a documentación REST
API Compatible con Terceros
El sistema cuenta con un método de conexión con algunos proveedores de timbrado existentes, lo que permite a los usuarios migrar sin necesidad de modificar su desarrollo existente. Solo es necesario actualizar la URL de conexión para comenzar a utilizar nuestra plataforma, asegurando una transición fluida y sin interrupciones en sus procesos de facturación electrónica.
- Descarga los ejemplos de conexión a la api Descargar ejemplos (Sandbox)
- Dentro de la configuración de Postman, en la pestaña variables, deberás agregar las variables con los valores correspondientes a tu identificador de cliente.
- Lista de endpoints disponibles
v1224v2