Timbrame.mx
API de Emisión 1.0
API de Emisión 1.0
API para emitir comprobantes, a la cual se le envía el XML estándar de Detecno para crear el CFDI, sellarlo y enviarlo a timbrar al PAC con mayor disponibilidad en el hub MultiPAC. También permite enviar a cancelación CFDIs emitidos con esta aplicación.
Adicionalmente, podrá buscar y descargar constancias de Retenciones previamente emitidas.
Documentación en español
English documentation
A continuación encontrará los enlaces para los ambientes productivo y demo, así como los EndPoint que podrá utilizar en ambos ambientes.
URL productiva:
URL demo:
https://detecno-factura-electronica.com/timbrame/cfdWebPos_NV_Demo/
Endpoints:
Generar Token api/Token/AutoR/TokenAppId
Generar Comprobante api/TimbrameServicio/GenerarCfdi
Consultar Factura api/TimbrameServicio/BuscarCfdi/?facturaId=
api/TimbrameServicio/BuscarCfdi/?uuid=
Cancelar Comprobante api/TimbrameServicio/CancelarCfdi
Obtener Constancia de Retenciones api/TimbrameServicio/BuscarConstanciaRet/?comprobanteId=
api/TimbrameServicio/BuscarConstanciaRet/?uuid=
El proceso de generación de comprobantes se realiza mediante las siguientes funciones:
Generar Token
Valida las credenciales para el uso de la API.
Se le envían las credenciales de acceso para generar una solicitud.
Se obtiene el Token de la autentificación.
Generar Comprobante
Genera un comprobante fiscal.
Se le envía un XML en representación de Base64.
Se obtiene el facturaId, la representación en Base64 del XML y del PDF, y el UUID.
Obtener Comprobante
Busca comprobantes previamente emitidos.
Se le envía el facturaId que identifica a la factura dentro del aplicativo o el UUID del comprobante asignado en el timbrado.
Se obtiene un archivo ZIP en Base64 que contiene el XML y PDF.
Cancelar Comprobante
Cancela los comprobantes previamente emitidos.
Se le envía el facturaId, el folio de sustitución y el motivo de cancelación.
Se obtiene el estatus de cancelación.
Obtener Constancia de Retención
Obtiene las constancias de retención previamente emitidas.
Se le envía el comprobanteId ó el UUID de la constancia de retención.
Se obtiene la representación en Base64 del XML, PDF y el UUID.
En el siguiente enlace encontrará las especificaciones de la API.
La API de Timbrame utiliza el XML con formato estándar de Detecno para recibir la información de las facturas a emitir.
En el siguiente enlace encontrará la estructura estándar de los archivos de entrada de Detecno:
La sección <CodigoBarras> del XML no se contempla en la API de Timbrame por lo que se recomienda no agregarla.
Adicionalmente, el servicio de archivos no está disponible para la API de Timbrame, por lo que el valor del campo "estatusIdArchivo" será ignorado.
1 El emisor envía las credenciales de acceso para generar un token de autenticación.
2 El emisor envía la información en un archivo XML en Base64, y recibe el estatus del comprobante, así como el XML y PDF del CFDI timbrado.
3 Opcionalmente, podrá consultar el comprobante y descargar el XML y PDF por medio del portal web.
4 El Emisor podrá enviar la petición de cancelación de comprobantes ingresando el facturaId, folio de sustitución y motivo de cancelación.
Diagrama conceptual API Timbrame