Timbra

Appearance

On this page

Colección de Postman ​

Prueba todos los endpoints de la API Masivo desde Postman sin escribir código.

Descargas ​

Contenido de la colección ​

CarpetaRequests
TimbradoTimbrado desde JSON, Timbrado desde XML (Pre-sellado), Emisión desde XML sin sellar
CancelaciónCancelar por CSD, Cancelar por UUID (JSON), Cancelar por UUID (ruta)

Cada request incluye:

  • Método y ruta completos.
  • Header Authorization: Bearer .
  • Cuerpo de ejemplo.
  • Descripción de los campos.
  • Respuesta de ejemplo.

Importar en Postman ​

  1. Abre Postman.
  2. Pulsa Import.
  3. Arrastra el archivo timbra-api.postman_collection.json o selecciónalo desde tu equipo.
  4. Importa también timbra-api.postman_environment.json.
  5. En la esquina superior derecha, selecciona el environment Timbra API - Sandbox.
  6. Edita la variable apiKey y pega tu llave tmb_test_....

Variables del environment ​

VariableValor inicialDescripción
baseUrlhttps://dashboard.timbra.com.mx/api/masivoURL base de la API.
apiKeytmb_test_tu_api_key_aquiTu API Key. Reemplázala por una real.
rfcEKU9003173C9RFC del emisor para pruebas.
uuidUUID de ejemploUUID del CFDI que quieres cancelar.
motivo02Motivo de cancelación.
folioSustitutoVacíoUUID del CFDI sustituto para motivo 01.

Reemplaza la llave de ejemplo

La colección incluye una llave ficticia. No funcionará hasta que pegues una API Key real en la variable apiKey.

Probar en Sandbox ​

  1. Crea una llave tmb_test_... en el panel de Timbra, en API Keys.
  2. Pega la llave en la variable apiKey.
  3. Mantén rfc en EKU9003173C9.
  4. Ejecuta Timbrado desde JSON.
  5. Revisa data.uuid y data.cfdi en la respuesta.

Puedes repetir la prueba sin consumir timbres. Consulta Ambientes Live y Test para conocer los RFCs permitidos.

Pasar a Live en Postman ​

  1. Crea una llave tmb_live_....
  2. Duplica el environment o cambia apiKey por la llave Live.
  3. Cambia rfc por el RFC real de tu cuenta.
  4. Verifica que el CFDI de ejemplo tenga los datos fiscales correctos.
  5. Ejecuta la petición. Cada timbrado exitoso descuenta un timbre.

Publicar la colección en Postman ​

Si quieres compartir la documentación con tus clientes desde Postman:

  1. Importa la colección en tu workspace.
  2. Ajusta las descripciones y los ejemplos si es necesario.
  3. Pulsa Publish en la colección.
  4. Comparte la URL pública de Postman Documenter.

La colección del repositorio es la fuente de verdad. Si cambia un endpoint, actualiza primero la colección y después la documentación del sitio.

Seguridad ​

  • No guardes llaves de producción en un environment compartido.
  • Usa una llave de Sandbox para las pruebas.
  • Si una llave se filtra, revócala de inmediato en el panel.

¿Prefieres integrarte con código? Empieza con Timbrado desde JSON.