TechByThree Logo

HUB CFDI

La API de Facturación Electrónica HUB CFDI 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 en un solo lugar.


Requisitos Previos a su Uso

Antes de utilizar la API, asegúrate de cumplir con los siguientes requisitos:

  1. 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í.
  2. CLIENT ID: Deberás conocer tu Identificador de cliente, será tu credencial que identifique tu cuenta dentro de la API, para eso ponte en contacto desde aquí y solicita una cuenta.
  3. Ambiente de Pruebas: Sugerimos tener instalado el software POSTMAN para realizar pruebas de conexión a la API usando la colección de ejemplos proporcionados en los cuales te puedes basar para hacer tu integración en tiempo récord.
  4. ¿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

  1. Token API: Consigue tu credencial para la conexión desde la Configuración de tu panel HUB CFDI este Token te permite generar una conexión segura entre tu sesión y nuestra API.
  2. ¿Qué es un token de API?
  3. 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.
  4. CLIENT ID: Consigue tu identificador de cliente, esta es una cadena única que identifica tus datos de cliente contra nuestra API Datos del cliente
  5. ¿Qué es un identificador de cliente?
  6. 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.
  7. Descarga los ejemplos de conexión a la api Descargar ejemplos POSTMAN (Sandbox)
  8. Una vez abierto Postman, ve a Archivo - Importar y pega ahí el vínculo de arriba, con eso será suficiente para cargar la colección de ejemplos y endpoint.
  9. 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.
  10. Consulta la documentación de la API para obtener información sobre los endpoints disponibles y cómo utilizarlos. Ir a documentación REST


¿Ya tienes tu cuenta de pruebas? Aquí los primeros pasos para iniciar:


Paso 1. Entra a tu panel y conoce tus datos de conexión.

Una vez dentro de tu panel, deberás entrar a Configuración y conocer tu CLIENT_ID y TOKEN API


Paso 2. Registra emisores de prueba.

Para iniciar tus pruebas será necesario cargar al menos un emisor de pruebas, el SAT tiene un listado de certificados de pruebas que podrás descargar más abajo una vez cargado podrás usar ese emisor para tus documentos de prueba.


Paso 3. Usa el proyecto de prueba POSTMAN para probar la conexión.

Sugerimos usar el software Postman para que envíes tus comprobantes de pruebas usando tus credenciales de prueba, podrás descargar tanto el software como el proyecto más abajo, sólo deberás importar el proyecto y listo.


Paso 4. Pase a producción.

Una vez que tengas tus pruebas satisfactorias y desees pasar a producción, deberás realizar tu pago y activaremos tu cuenta

en minutos.



v0527v1