Correo electrónico

La API de Facturación de Tandia se encarga de notificar mediante el envío de un correo electrónico a los clientes cuando sus comprobantes han sido validados, adjuntando los siguientes archivos:

• XML
• CDR
• PDF

Para que el envío se realice se debe especificar una dirección de correo electrónica válida en el campo customer.email de la siguiente manera:

"customer": {
    "document_type": "6",
    "document_number": "20740021552",
    "registration_name": "Jane Doe SAC",
    "email": "jdoe@business.com"
},

PDF

La API de Facturación de Tandia se encarga de realizar el PDF del comprobante en un formato A4 estándar.

Si al momento de crear la compañía configuraste un logo, este aparecerá en el PDF, de lo contrario se mostrará de la siguiente manera:

Campos extras

Para mostrar información extra solo a nivel del PDF del documento, la API de Facturación de Tandia cuenta con los siguientes campos adicionales:

"metadata": {
  "customer_address": "Av. Dirección del cliente",
  "seller": "Nombre del vendedor",
  "payments": [ // Métodos de pago realizados
    {
      "tag_amount": "EFECTIVO", // Nombre descriptivo
      "amount": 136.00 // Monto correspondiente
    },
    {
      "tag_amount": "YAPE",
      "amount": 100.00
    }
  ]
}

Los cuales se mostrarían dentro del PDF de la siguiente manera:

Personalización

Si deseas trabajar con un archivo PDF propio, puedes enviarlo añadiendo el key document_pdf en cada solicitud de documento, por ejemplo:

POST /api/invoice
Host: invoice.test.tandia.io
Content-Type: application/json
Authorization: Bearer token-de-api

{
  "number": "FF10-00000029",
  "date": "2023-11-01T18:46:00-05:00",
  "customer": {
    "document_type": "6",
    "document_number": "20740021552",
    "registration_name": "Jane Doe SAC",
    "email": "jdoe@business.com"
  },
  ...
  "document_pdf": "https://s3.midominio.com/documents/FF10-00000029.pdf"
  ...
}

Al añadir este key la API de Facturación de Tandia no elaborará el PDF del comprobante y usará el proporcionado al momento de la notificación mediante el envío de un correo electrónico al cliente.