Generar una Guía de Remisión - Transportista

post

https://api.alanube.co/per/v1/remission-guides/carrier

Este endpoint permite generar una guía de remisión electrónica (Transportista).
La guía de remisión transportista es un documento emitido por el transportista que sustenta el traslado de bienes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

companyId

string

required

length between 26 and 26

Id de la empresa

Body Params

Objeto JSON con la información de la guía de remisión transportista

Datos generales solicitados para emitir una Guía de Remisión - Transportista

information

object

required

Información general de la guía de remisión - Transportista.

Tipo de documento: 31 (Guía de remisión - Transportista)

XML tag: <DespatchAdvice>

carrierData

object

Datos del transportista (emisor de la guía de remisión transportista).

XML tag: <cac:DespatchSupplierParty>

supplier

object

required

Información del remitente (en guía de remisión transportista).

XML tag: <cac:Shipment> <cac:Delivery> <cac:DespatchParty>

recipient

object

required

Datos del destinatario (en guía de remisión transportista).

XML tag: <cac:DeliveryCustomerParty>

transferDetails

object

required

Datos del traslado (en guía de remisión transportista).

XML tag: <cac:Shipment>

vehicles

object

required

Datos de los vehículos utilizados para el traslado.

XML tag: <cac:TransportHandlingUnit> <cac:TransportEquipment>

driverDetails

object

required

Datos de los conductores (principal y secundarios).

XML tag: <cac:ShipmentStage>

startingPoint

object

required

Dirección del punto de partida.

XML tag: <cac:Shipment> <cac:Delivery> <cac:Despatch> <cac:DespatchAddress>

arrivalPoint

object

required

Dirección del punto de llegada.

XML tag: <cac:Shipment> <cac:Delivery> <cac:DeliveryAddress>

itemDetails

array of objects

required

length ≥ 1

Bienes a transportar.

XML tag: <cac:DespatchLine>

itemDetails*

quantity

number

required

≥ 0

Cantidad del ítem.

XML tag: <cbc:DeliveredQuantity>

unitOfMeasure

string

required

length between 2 and 5

Unidad de medida del ítem (Catálogo N° 03 / N° 65).

XML tag: <cbc:DeliveredQuantity> @unitCode

description

string

required

length ≤ 500

Descripción detallada del ítem.

XML tag: <cac:Item> <cbc:Description>

code

string

length ≤ 30

Código interno del producto o servicio, asignado por ti. Ejemplo: C001.

XML tag: <cac:Item> <cac:SellersItemIdentification> <cbc:ID>

sunatProductCode

string

^[0-9]{1,8}$

Código producto SUNAT (Catálogo N° 25).

XML tag: <cac:Item> <cac:CommodityClassification> <cbc:ItemClassificationCode>

gtinCode

string

length ≤ 14

Código GTIN.

XML tag: <cac:Item> <cac:StandardItemIdentification> <cbc:ID>

damCode

string

length ≤ 23

⚠️ Condicional: Solo para motivo de traslado exportación o importación.

a) Ejemplo (DAM):

xxxx(serie)/xxx-xxxx-10-xxxxxx(DAM)

1/123-1234-10-123456

b) Ejemplo (DS):

xxxx(serie)/xxx-xxxx-18-xxxxxx(DS)

1/123-1234-18-123456

XML tag: <cac:Item> <cac:AdditionalItemProperty>

relatedDocuments

array of objects

length ≥ 1

Lista de documentos relacionados al traslado. Solo se permite uno, excepto hasta 2 si hay códigos "31","65","66","67","68" o "69",
o más de 2 si hay código "09" con serie electrónica.

Sin GRE-remitente en transporte público, usar según origen-destino:

"93" ZOFRATACNA → Zona Comercial de Tacna,

"94" ingreso al país → ZED,

"95" exterior → ZOFRATACNA.

No referenciar GRE Única ni GRE en estado Baja.

XML tag: <cac:AdditionalDocumentReference>

relatedDocuments

documentType

string

required

length ≤ 2

Código del tipo de documento relacionado, catalogo "Documentos relacionados al transporte de mercancías"

Cuando no se emitió GRE-remitente en transporte público:

"93": traslado desde ZOFRATACNA hacia Zona Comercial de Tacna.
"94": traslado desde el punto de ingreso al país hacia una ZED.
"95": traslado desde el exterior hacia la ZOFRATACNA.

Los códigos 93, 94 y 95 no requieren el campo series.

No puede referenciarse una GRE Única ni una GRE dada de baja.

XML tag: <cbc:DocumentTypeCode>

series

string

length ≤ 4

Serie del documento relacionado. Solo aplica para los tipos de documento que tienen estructura serie + número: "01", "03", "04", "09", "12", "31" y "48". No debe enviarse para los demás tipos.

En el XML se concatena con number como {series}-{number}.

XML tag: <cbc:ID>

number

string

required

length ≤ 8

Número correlativo del documento relacionado, sin ceros a la izquierda. Para documentos relacionados distintos a facturas o boletas, cuando documentType pertenezca a los valores "92", "93", "94" o "95", se debe informar el número de la cita, orden de entrega o solicitud de traslado, según corresponda.

XML tag: <cbc:ID>

ruc

string

^[0-9]{11}$

RUC del emisor del comprobante relacionado.

Solo se debe informar cuando el comprobante no fue emitido por el mismo remitente.

XML tag: <cac:IssuerParty> <cac:PartyIdentification> <cbc:ID>

subcontractorCompanyData

object

Datos de empresa que subcontrata.

XML tag: <cac:Shipment> <cac:Consignment> <cac:LogisticsOperatorParty>

payerData

object

Datos de quien paga el servicio de transporte - solo se completa cuando paga un tercero.

XML tag: <cac:OriginatorCustomerParty>

201Objeto que representa la respuesta de creación de la guía de remisión transportista, que puede ser la aceptación o el rechazo del documento por parte de la SUNAT

400Objeto que representa una respuesta de error por validaciones

404Objeto que representa una respuesta de error debido a que no se ha encontrado el recurso al que se intenta acceder

500Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

502Objeto que representa la respuesta cuando ocurre un error de comunicación con la SUNAT al enviar la guía de remisión transportista (timeout, ticket no encontrado, o error transitorio del servidor)