Timbrame

Plataforma de facturación electrónica CFDI 4.0 con timbrado MultiPAC

Timbrame es la plataforma de facturación electrónica de Detecno para empresas y desarrolladores: permite emitir, timbrar, consultar y cancelar comprobantes fiscales (CFDI 4.0 y Retenciones) desde el portal web o integrando tu ERP mediante la API, con certificación a través del hub MultiPAC.

Funciones principales

  • Emisión de comprobantes

    Crea, sella y timbra comprobantes CFDI 4.0 y Retenciones.

    Ingreso Egreso Traslado Pago Nómina Retenciones

  • Complementos

    Soporte nativo para los complementos del SAT y de sector.

    Carta Porte 3.1 Comercio Exterior 2.0 Detallista Pagos 2.0 Leyendas Fiscales Impuestos Locales Donatarias Divisas

  • Emisión síncrona y asíncrona

    Elige la modalidad por petición:

    • Síncrona: respuesta inmediata, con UUID y sello al momento.
    • Asíncrona: procesa lotes en segundo plano con notificación por webhook o consulta de estatus por proceso.

  • Representación impresa

    PDF con plantillas personalizables por emisor y descarga individual o consolidada.

  • Administración

    Portal de consulta, cifras de control y bitácora de cada intento de timbrado con su request original.

Cómo integrar con Timbrame

Timbrame tiene tres casos de uso para emitir comprobantes digitales. Los tres comparten el mismo motor de armado, validación y timbrado, así que puedes combinarlos según tu operación. Elige el tuyo y consulta más abajo la guía técnica para integrarte.

Portal Web

Captura guiada en app.timbrame.mx: facturas con cualquier complemento, clientes, series y descarga de XML/PDF sin necesidad de integración.

API REST

Integra tu ERP enviando JSON con autenticación Bearer: emisión síncrona con respuesta inmediata, o asíncrona con webhooks.

Normalización

Adaptamos el proceso a tus datos de origen: envíanos tu layout tal como lo genera tu sistema — TXT delimitado por pipes o XML en estándar del SAT sin sello ni timbre — y Timbrame lo normaliza, valida y timbra por ti.

Guía técnica: Timbrame API

Para facilitar la integración, hemos dividido la documentación en tres pilares fundamentales.

Abrir Playground Descargar colección Postman

Autenticación y configuración inicial

Todo consumo de la API requiere un token de acceso y un emisor configurado con su Certificado de Sello Digital vigente.

Autenticación
  • Base URL de producción: https://api.timbrame.mx
  • Incluye en cada petición el encabezado Authorization: Bearer {token}; el token se emite por aplicación y usuario (OAuth2).
Configuración del emisor
  • Carga del CSD (.cer, .key y contraseña) — POST /Emisor/CSDAgregar
  • Catálogos del SAT (regímenes, formas de pago, unidades…) — GET /SAT/*
El CSD se valida en línea al cargarlo: certificado vigente, contraseña correcta y RFC coincidente con el emisor registrado.

Especificaciones de la API de Emisión

Elige la modalidad según el volumen y el tiempo de respuesta que tu integración necesita:

Tipo de servicio Formato Endpoints y aplicación
Emisión
Emisión Síncrona JSON POST /Factura/Facturar (individual) y POST /Factura/Multiple (lote). Respuesta inmediata con UUID, sello y datos de timbrado.
Emisión Asíncrona JSON POST /Factura/EmisionAsync responde 202 con un ProcesoId; el resultado llega por webhook o se consulta en GET /Factura/EstatusProcesoAsync/{procesoId}.
FacturaTXT TXT POST /FacturaTXT/Emision (síncrono) o POST /FacturaTXT/EmisionAsync; consulta el resultado con POST /FacturaTXT/Proceso.
Consulta
Consulta y PDF JSON POST /Factura/ObtenerFacturas/{emisorUID} para listar comprobantes; GET /Factura/ObtenPDF?UUID={uuid} para la representación impresa.
Formatos disponibles: JSON TXT Excel (carga masiva) XML (importación)

Resolución de Problemas

Cada intento de emisión — exitoso o fallido — queda registrado en la Matriz Técnica con código de error, descripción, acción recomendada y el request original que lo generó.

  • Cifras de Control — consulta en el portal los intentos por rango de fechas y expórtalos a Excel.
  • Request original de un intento — GET /CifrasControl/Request/{uid} devuelve el JSON enviado, para reproducir el caso.
Ante un error de emisión, la respuesta incluye un código de seguimiento (MatrizTecnicaUID): compártelo con soporte para un diagnóstico inmediato.

Requisitos de integración

  • Cuenta de aplicación con token de API (OAuth2) activo
  • CSD vigente del emisor cargado y validado en la plataforma