Guías de remisión

Consulta una guía de remisión

get/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.

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.