Enviar un correo electrónico con una factura adjunta

Crear una factura emitida

En el ejemplo siguiente aprenderás cómo generar una factura emitida con el método de entrega configurado como email.

Para enviar una factura por email, asegúrate de que transport_type_code esté configurado como email y proporciona un email válido (dirección de correo electrónico). Además, especifica el document_type_code que quieres adjuntar al email. En este ejemplo, está configurado como xml.ubl.invoice.xrechnung.v22.

Ejemplo de solicitud:

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'content-type: application/json' \
  --data '
    {
      "send_after_import": false,
        "invoice": {
          "number": "2",
          "date": "2024-03-27",
          "due_date": "2024-03-29",
          "terms": "custom",
          "ponumber": "1",
          "buyer_reference": "01002-000005228-65",
          "contact": {
              "name": "Muster GmbH",
              "address": "Musterstraße 45",
              "postalcode": "10115",
              "city": "Berlin",
              "province": "Berlin",
              "country": "de",
              "email": "john.doe@example.com",
              "transport_type_code": "email",
              "document_type_code": "xml.ubl.invoice.xrechnung.v22"
          },
          "invoice_lines_attributes": [
            {
              "unit": 1,
              "quantity": 1,
              "price": 1,
              "description": "Descripción de línea",
              "article_code": "Código de artículo",
              "taxes_attributes": [
                {
                  "category": "S",
                  "name": "MwSt",
                  "percent": 19
                }
              ]
            }
          ]
      }
  }'

Enviar la factura

Antes de la transmisión, verificamos meticulosamente la presencia de todos los datos requeridos y validamos el documento según los requisitos del transporte y del tipo de documento. Esto garantiza que la factura cumple todos los criterios necesarios para una entrega exitosa.

Enlace a la Referencia de la API

Ejemplo de solicitud:

curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{invoice-id} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Rastrear tu factura

En el caso de las facturas enviadas por email, la trazabilidad del estado es limitada. Principalmente puedes verificar si la factura se ha enviado correctamente, en cuyo caso su estado sería sent. Por el contrario, si se produce un error durante el proceso de envío que impide que la factura sea enviada, el estado cambiará a error. Esta actualización de estado indica que la factura encontró un problema y no pudo entregarse.