Generar una Guía de Remisión - Remitente

post

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

Este endpoint permite generar una guía de remisión electrónica (Remitente).
La guía de remisión es un documento 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

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

information

object

required

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

XML tag: <DespatchAdvice>

supplier

object

Información del remitente.

XML tag: <cac:DespatchSupplierParty>

recipient

object

required

Datos del destinatario.

XML tag: <cac:DeliveryCustomerParty>

transferDetails

object

required

Datos del traslado.

XML tag: <cac:Shipment>

carrier

object

required

Datos del transportista.

XML tag: <cac:ShipmentStage> <cac:CarrierParty>

startingPoint

object

required

Dirección del punto de partida.

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

arrivalPoint

object

required

Dirección del punto de llegada.

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

driverDetails

object

Datos del conductor.

⚠️ Condicional: Este dato solo debe enviarse cuando el tipo de transporte sea privado.

XML tag: <cac:ShipmentStage>

itemDetails

array of objects

length ≥ 1

Lista de bienes a trasladar. Obligatorio en todos los casos, excepto cuando information.reasonForTransfer es "19" y relatedDocuments contiene documentType "92" (Cita/Orden Entrega Mercancías del Terminal Portuario); en ese caso no debe enviarse ya que la API gestiona internamente la información requerida.

XML tag: <cac:DespatchLine>

itemDetails

quantity

number

required

≥ 0

Cantidad.

XML tag: <cbc:DeliveredQuantity>

unitOfMeasure

string

required

length between 1 and 5

Unidad de medida del ítem.
El catálogo aplicable depende del motivo de traslado:

Motivos "08", "09" o "19" con documento relacionado "50" (DAM) o "52" (DS): debe ser un código del Catálogo N°65.
Motivo "19" con documento relacionado "91" (Manifiesto de Carga): debe ser "U" (Unidad).
Motivo "13": debe ser un código del Catálogo N°03 o N°65.
Resto de motivos: debe ser un código del Catálogo "Unidades".

Mapeo UBL:
cbc:DeliveredQuantity@unitCode

description

string

length ≤ 500

Descripción detallada del producto o servicio.

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.

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

deprecated

DEPRECADO. Usar dam.number y dam.seriesNumber.

XML tag: <cac:Item> <cac:AdditionalItemProperty> (Catálogo 55 código 7021)

normalizedItem

boolean

Indica si el bien está normalizado.

true = bien normalizado,

false = no normalizado.

Cuando es true, son obligatorios tariffCode y sunatProductCode.

XML tag: <cac:Item> <cac:AdditionalItemProperty> (Catálogo 55 código 7022)

tariffCode

string

^(?!0+$)[0-9]{1,10}$

Partida arancelaria del bien. Numérico de hasta 10 caracteres, no se aceptan solo ceros.

Obligatorio cuando normalizedItem es true y no existe el indicador de traslado total de la DAM o DS.

Debe corresponder a una partida arancelaria vigente en SUNAT.

XML tag: <cac:Item> <cac:AdditionalItemProperty> (Catálogo 55 código 7020)

dam

object

Datos de la Declaración Aduanera de Mercancías (DAM) o Declaración Simplificada (DS) asociada al bien.

Aplica cuando information.reasonForTransfer es "08", "09" o "19" con documento relacionado "50" (DAM) o "52" (DS). Reemplaza al campo damCode.

cargoManifest

object

Datos del ítem asociado al Manifiesto de Carga.

Solo aplica cuando information.reasonForTransfer es "19" y el documento relacionado es "91" (Manifiesto de Carga).

relatedDocuments

array of objects

length ≥ 0

Documento relacionado.

XML tag: <cac:AdditionalDocumentReference>

relatedDocuments

201Objeto que representa la respuesta de creación de la guía de remisión, 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 (timeout, ticket no encontrado, o error transitorio del servidor)