Guías de remisión

Actualiza una guía de remisión

post/sales/waybills/{id}

Request

  • Base URL: https://api.datil.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.datil.com/sales/waybills/{id}
  • Auth: none declared

Path parameters

idstring required

Identificador único del documento, generado por Dátil.

Request body

issue_datestring required

Fecha de emisión en formato Epoch o ISO 8601.

seriesstring required

Serie del documento.

sequencestring required

Secuencia numérica del documento.

notestring

Nota con información adicional para la factura.

sales_order_numberstring

Número de orden de venta.

purchase_order_numberstring

Número de orden de compra.

recipient_legal_namestring required

Nombre del cliente.

recipient_tax_idstring required

Identificación tributaria del receptor.

recipient_tax_id_typestring required

Tipo de identificación tributaria del receptor.

recipient_emailstring

Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.

auto_advanceboolean

Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es true.

Example request

{
  "issue_date": "1791394186",
  "series": "F001",
  "vendor_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "tax_code": "0000",
    "country": "PE"
  },
  "sequence": "1",
  "note": "Gracias por tu compra.",
  "sales_order_number": "1234",
  "purchase_order_number": "1234",
  "order_reference": {
    "number": "T001-00001",
    "type": "09"
  },
  "related_document": {
    "number": "F001-00001",
    "type": "01"
  },
  "recipient_legal_name": "Jose Mario",
  "recipient_tax_id": "20601595665",
  "recipient_tax_id_type": "pe-ruc",
  "recipient_email": "prueba@prueba.com",
  "recipient_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "city": "Lima",
    "province": "Lima",
    "tax_code": "0000",
    "country": "PE"
  },
  "supplier": {
    "legal_name": "Jose Mario",
    "tax-id": "212334567",
    "tax-id-type": "pe-ruc"
  },
  "shipment": {
    "handling_code": "01",
    "description": "Venta de productos",
    "weight_unit": "KG",
    "weight": "100.00",
    "quantity": "1",
    "transport_mode_code": "01",
    "start_date": "2021-08-01",
    "delivery_date": "2021-08-01",
    "carrier": {
      "legal_name": "Transportes Dátil",
      "tax_id": "20601595665",
      "tax_id_type": "pe-ruc",
      "license_plate": "GSI-999",
      "email": "prueba@prueba.com",
      "driver_id": "Transportes Dátil",
      "driver_id_type": "pe-ruc"
    },
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": "PE"
    },
    "origin_address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": "PE"
    },
    "container_number": "1",
    "port_code": "222"
  },
  "line_items": [
    {
      "sku": "A001",
      "item_classification_code": "1234",
      "description": "Servicio ABC",
      "unit_of_measurement": "KG",
      "unit_code": "1",
      "quantity": "1"
    }
  ],
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ],
  "auto_advance": true
}

Response

OK

idstring required

Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.

issue_datestring date-time required

Fecha de emisión del documento, en formato RFC3339.

numberstring required

Número de documento, generado en el siguiente formato: series-sequence

environment'live' | 'test' required

Tipo de ambiente del documento.

live: Ambiente de producción. test: Ambiente de pruebas.

status'draft' | 'active' | 'void' required

Estatus del documento

draft: Borrador active: Activo void: Anulado.

typestring required

Tipo de documento.

seriesstring required

Serie del documento

sequencenumber double required

Secuencia numérica del documento.

notestring

Nota con información adicional para la factura.

sales_order_numberstring

Número de orden de venta.

purchase_order_numberstring

Número de orden de compra.

recipient_legal_namestring required

Nombre del receptor.

recipient_commercial_namestring

Nombre comercial del receptor.

recipient_emailstring

Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.

vendor_legal_namestring required

Nombre legal del vendedor.

vendor_commercial_namestring required

Nombre comercial del vendedor.

vendor_tax_idstring required

Identificación tributaria del vendedor.

Example response

{
  "id": "81wxc0qk5cgz4a7z3550a3art3",
  "issue_date": "2026-10-07T17:29:46Z",
  "number": "T001-1",
  "type": "pe/waybill",
  "country": {
    "code": "PE",
    "name": "Perú"
  },
  "series": "F001",
  "sequence": 1,
  "note": "Gracias por tu compra.",
  "sales_order_number": "1234",
  "purchase_order_number": "1234",
  "order_reference": {
    "number": "T001-00001",
    "type": "09"
  },
  "related_document": {
    "number": "F001-00001",
    "type": "01"
  },
  "recipient_legal_name": "Jose Mario",
  "recipient_commercial_name": "Jose Mario",
  "recipient_tax_id_type": {
    "type": "pe-ruc",
    "code": "6",
    "name": "RUC"
  },
  "recipient_email": "prueba@prueba.com",
  "recipient_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "city": "Lima",
    "province": "Lima",
    "tax_code": "0000",
    "country": {
      "code": "PE",
      "name": "Perú"
    }
  },
  "vendor_legal_name": "Jose Mario",
  "vendor_commercial_name": "Jose Mario",
  "vendor_tax_id": "20601595665",
  "vendor_tax_id_type": {
    "type": "pe-ruc",
    "code": "6",
    "name": "RUC"
  },
  "vendor_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "city": "Lima",
    "province": "Lima",
    "tax_code": "0000",
    "country": {
      "code": "PE",
      "name": "Perú"
    }
  },
  "tax_clearance": {
    "void_requests": [
      {
        "id": "81wxc0qk5cgz4a7z3550a3art3",
        "type": "pe/void-request",
        "series": "RA-20210315",
        "sequence": 1,
        "number": "RA-20210315-3",
        "tax_clearance": {
          "status": "cleared",
          "status_description": "ACEPTADO",
          "status_code": "0",
          "ticket": "1234567890",
          "date": "1791394186",
          "message": "El documento ha sido aceptado.",
          "ack_xml": "<xml></xml>",
          "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
          "xml": "https://api.datil.com/documents/1234/xml",
          "pdf": "https://api.datil.com/p/1234",
          "warnings": [
            {
              "status_code": "0000",
              "message": "Documento de pruebas"
            }
          ]
        }
      }
    ],
    "status": "cleared",
    "status_description": "ACEPTADO",
    "status_code": "0",
    "ticket": "1234567890",
    "date": "1791394186",
    "message": "El documento ha sido aceptado.",
    "ack_xml": "<xml></xml>",
    "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
    "xml": "https://api.datil.com/documents/1234/xml",
    "pdf": "https://api.datil.com/p/1234",
    "warnings": [
      {
        "status_code": "0000",
        "message": "Documento de pruebas"
      }
    ]
  },
  "supplier": {
    "legal_name": "Jose Mario",
    "number": "212334567",
    "type": {
      "type": "pe-ruc",
      "code": "6",
      "name": "RUC"
    }
  },
  "shipment": {
    "handling_code": "01",
    "description": "Venta de productos",
    "weight_unit": "KG",
    "quantity": "1",
    "transport_mode_code": "01",
    "start_date": "2026-10-07T17:29:46Z",
    "delivery_date": "2026-10-07T17:29:46Z",
    "carrier": {
      "legal_name": "Transportes Dátil",
      "tax_id": "20601595665",
      "tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "license_plate": "GSI-999",
      "email": "prueba@prueba.com",
      "driver_id": "Transportes Dátil",
      "driver_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      }
    },
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": {
        "code": "PE",
        "name": "Perú"
      }
    },
    "origin_address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": {
        "code": "PE",
        "name": "Perú"
      }
    },
    "container_number": "1",
    "port_code": "222"
  },
  "line_items": [
    {
      "sku": "A001",
      "item_classification_code": "1234",
      "description": "Servicio ABC",
      "unit_of_measurement": "KG",
      "unit_code": "1",
      "quantity": "1"
    }
  ],
  "void_requests": [
    {
      "id": "81wxc0qk5cgz4a7z3550a3art3",
      "issue_date": "2026-10-07T17:29:46Z",
      "series": "F001",
      "number": "FC01-1",
      "currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "country": {
        "code": "PE",
        "name": "Perú"
      },
      "type": "pe/purchase-retention-void-request",
      "recipient_legal_name": "Jose Mario",
      "recipient_tax_id": "20601595665",
      "recipient_tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "recipient_email": "prueba@prueba.com",
      "recipient_address": {
        "line_1": "Calle A",
        "locality": "Lima",
        "administrative_district_level_1": "Miraflores",
        "administrative_district_level_2": "Lima",
        "city": "Lima",
        "province": "Lima",
        "tax_code": "0000",
        "country": {
          "code": "PE",
          "name": "Perú"
        }
      },
      "vendor_legal_name": "Jose Mario",
      "vendor_commercial_name": "Jose Mario",
      "vendor_tax_id": "20601595665",
      "vendor_tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "vendor_address": {
        "line_1": "Calle A",
        "locality": "Lima",
        "administrative_district_level_1": "Miraflores",
        "administrative_district_level_2": "Lima",
        "city": "Lima",
        "province": "Lima",
        "tax_code": "0000",
        "country": {
          "code": "PE",
          "name": "Perú"
        }
      },
      "tax_clearance": {
        "void_requests": [
          {
            "id": "81wxc0qk5cgz4a7z3550a3art3",
            "type": "pe/void-request",
            "series": "RA-20210315",
            "sequence": 1,
            "number": "RA-20210315-3",
            "tax_clearance": {
              "status": "cleared",
              "status_description": "ACEPTADO",
              "status_code": "0",
              "ticket": "1234567890",
              "date": "1791394186",
              "message": "El documento ha sido aceptado.",
              "ack_xml": "<xml></xml>",
              "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
              "xml": "https://api.datil.com/documents/1234/xml",
              "pdf": "https://api.datil.com/p/1234",
              "warnings": [
                {
                  "status_code": "0000",
                  "message": "Documento de pruebas"
                }
              ]
            }
          }
        ],
        "status": "cleared",
        "status_description": "ACEPTADO",
        "status_code": "0",
        "ticket": "1234567890",
        "date": "1791394186",
        "message": "El documento ha sido aceptado.",
        "ack_xml": "<xml></xml>",
        "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
        "xml": "https://api.datil.com/documents/1234/xml",
        "pdf": "https://api.datil.com/p/1234",
        "warnings": [
          {
            "status_code": "0000",
            "message": "Documento de pruebas"
          }
        ]
      },
      "voided_documents": [
        {
          "number": "R001-1",
          "series": "R001",
          "document_type": "01",
          "sequence": 1,
          "void_reason": "Anulación por error en la información."
        }
      ]
    }
  ],
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.