Skip to content

Guias de Remision (09)

Guias de Remision (despatch notes) document the transfer of goods between locations. They include transport details, carrier information, and origin/destination addresses.

Endpoint

POST /api/despatch-advices

Authentication

Authorization: Bearer sk_live_YOUR_API_KEY or Authorization: Bearer JWT_TOKEN

Request body

{
  "series": "T001",
  "correlative": 1,
  "issueDate": "2026-02-20",
  "despatchType": "09",
  "transferReason": "01",
  "transferDescription": "Venta de mercaderia",
  "grossWeight": 150.5,
  "weightUnit": "KGM",
  "numberOfPackages": 10,
  "carrier": {
    "identityType": "6",
    "identityNumber": "20456789012",
    "name": "Transportes Rapidos SAC",
    "registrationNumber": "ABC-123"
  },
  "driver": {
    "identityType": "1",
    "identityNumber": "12345678",
    "name": "Carlos Transportista",
    "licenseNumber": "Q12345678"
  },
  "origin": {
    "ubigeo": "150101",
    "address": "Av. Industrial 500, Lima"
  },
  "destination": {
    "ubigeo": "040101",
    "address": "Calle Comercio 200, Arequipa"
  },
  "recipient": {
    "identityType": "6",
    "identityNumber": "20100047218",
    "name": "Empresa Destino SAC"
  },
  "items": [
    {
      "code": "PROD-001",
      "description": "Cajas de producto terminado",
      "quantity": 100,
      "unitCode": "NIU"
    }
  ]
}

Field reference

Root fields

Field	Type	Required	Description
`series`	string	Yes	Series. Must match pattern `T\d{3}` (e.g., `T001`)
`correlative`	number	Yes	Sequential number
`issueDate`	string	Yes	Issue date in `YYYY-MM-DD` format
`despatchType`	string	No	Document type. Default: `09`
`transferReason`	string	Yes	SUNAT transfer reason code (see below)
`transferDescription`	string	No	Description of the transfer
`grossWeight`	number	Yes	Total gross weight (must be positive)
`weightUnit`	string	No	Weight unit code. Default: `KGM`
`numberOfPackages`	number	No	Number of packages
`carrier`	object	No	Carrier company data
`driver`	object	No	Driver data
`origin`	object	Yes	Origin location
`destination`	object	Yes	Destination location
`recipient`	object	Yes	Recipient data
`items`	array	Yes	Items being transported (minimum 1)

Transfer reason codes

Code	Description
`01`	Venta
`02`	Compra
`04`	Traslado entre establecimientos
`08`	Importacion
`09`	Exportacion
`13`	Otros
`14`	Venta sujeta a confirmacion
`17`	Traslado de bienes para transformacion
`18`	Traslado emisor itinerante
`19`	Traslado zona primaria

Carrier object

Field	Type	Required	Description
`identityType`	string	Yes	Identity type (typically `6` for RUC)
`identityNumber`	string	Yes	RUC of the transport company
`name`	string	Yes	Company name
`registrationNumber`	string	No	Vehicle registration number

Driver object

Field	Type	Required	Description
`identityType`	string	Yes	Identity type (typically `1` for DNI)
`identityNumber`	string	Yes	DNI number
`name`	string	Yes	Driver full name
`licenseNumber`	string	Yes	Driver license number

Location object (origin and destination)

Field	Type	Required	Description
`ubigeo`	string	Yes	UBIGEO code (6 digits)
`address`	string	Yes	Full address

Item object (despatch)

Field	Type	Required	Description
`code`	string	Yes	Product code
`description`	string	Yes	Description
`quantity`	number	Yes	Quantity (must be positive)
`unitCode`	string	Yes	Unit of measure code

Note: Despatch note items do not include prices or tax information.

Response

Success (201 Created)

{
  "id": "cm3mno345",
  "documentId": "20123456789-09-T001-00000001",
  "status": "ACCEPTED",
  "cdrResponseCode": "0",
  "cdrDescription": "La Guia de Remision numero T001-00000001, ha sido aceptada",
  "ticket": null
}

Code examples