falconix
Generar

Guia de remision

Para efectuar esta consulta solo es necesario acceder a la siguiente URL, este dato es extraido de la SUNAT
POST
URL/guia-remision?token=TOKEN

Por favor, asegúrese de reemplazar TOKEN con el token válido para autenticar su solicitud.

La unidad de medida esta puesta por defecto en KGM (KILOGRAMO)
Aun se encuentra en desarrollo

Datos a enviar

Guía de Remisión - Transporte Publico

Ejemplo de Guía de Remisión para la boleta B002 utilizando transporte publico. Se incluye información de la empresa que realizará el envío:

{
  "empresa": {
    "empresa": "MODAS TEXTILES DRAGO S.A.C.",
    "ruc": "20608386387"
  },
  "guia": {
    "serie": "B002",
    "numero": "12316",
    "fecha_emision_sf": "2024-01-16",
    "fecha_traslado_sf": "2024-01-16",
    // highlight-start
    "guia_modalidad_traslado_id": "01",
    // highlight-end
    "destinatario_id": "123",
    "partida_ubigeo": "150117",
    "partida_direccion": "AV. LOS OLIVOS",
    "llegada_ubigeo": "140105",
    "llegada_direccion": "AV. AGRICULTURA",
    "notas": "",
    "codigo_tipo_destinatario": "1",
    "numero_documento": "80241425",
    "entidad": "LAURA MONTES OLIVEROS",
    "peso_total": "10",
    "unidad_medida_peso_bruto": "KGM",
    "numero_bultos": "1",
    "numero_documento_transporte": "40708627",
    "entidad_transporte": "SHALOM EMPRESARIAL S.A.C.",
    "numero_mtc_transporte": "20512528458",
    "codigo_guia_modalidad_traslado": "07"
  },
  "detalles": [
    {
      "unidad_medida": "NIU",
      "cantidad": "1",
      "producto": "POLO DRAGO ROJO",
      "codigo_producto": "U123"
    }
  ]
}

Guía de Remisión - Transporte Privado

Ejemplo de Guía de Remisión para la boleta B002 utilizando transporte privado. Se incluye información del conductor del transporte que realizará el envío:

{
  "empresa": {
    "empresa": "MODAS TEXTILES DRAGO S.A.C.",
    "ruc": "20608386387"
  },
  "guia": {
    "serie": "B002",
    "numero": "12316",
    "fecha_emision_sf": "2024-01-16",
    "fecha_traslado_sf": "2024-01-16",
    "guia_modalidad_traslado_id": "02",
    "destinatario_id": "123",
    "partida_ubigeo": "150117",
    "partida_direccion": "AV. LOS OLIVOS",
    "llegada_ubigeo": "140105",
    "llegada_direccion": "AV. AGRICULTURA",
    "notas": "",
    "codigo_tipo_destinatario": "1",
    "numero_documento": "80241425",
    "entidad": "LAURA MONTES OLIVEROS",
    "peso_total": "10",
    "unidad_medida_peso_bruto": "KGM",
    "numero_bultos": "1",
    "conductor_dni": "75237662",
    "conductor_nombres": "Ronal James",
    "conductor_apellidos": "Llapapsca Montes",
    "conductor_licencia": "BM-001",
    "vehiculo_placa": "MB-451",
    "codigo_guia_modalidad_traslado": "01"
  },
  "detalles": [
    {
      "unidad_medida": "NIU",
      "cantidad": "1",
      "producto": "POLO DRAGO ROJO",
      "codigo_producto": "U123"
    }
  ]
}

Respuesta obtenida

Si la consulta fue satisfactoria, obtendra el siguiente resultado

{
  "success": true,
  "data": {
    "xml": "URL/files/guia_electronica/XML/20608386387-09-B002-12316.xml"
  }
}

Caso contrario obtendra el siguiente:

{
  "success": false,
  "data": {
    "xml": ""
  }
}

import TableDrago from "@site/src/components/table";

Parametros

empresa

Informacion de la Empresa la cual realizara la emision de la Guia de remision.

empresa
string

Nombre de la empresa

ruc
string

Ruc de la empresa

codigo_sucursal_sunat
string

Codigo SUNAT de la sucursal

guias_client_id
string

id cliente SUNAT

guias_client_secret
string

cliente secreto SUNAT

usu_secundario_produccion_user
string

usuario secundario de produccion SUNAT

usu_secundario_produccion_password
string

contraseña del usuario secundario

guia

Informacion necesaria para emitir la guia.

serie
string

Codigo de serie (ver diccionario)

numero
string

Número de serie

fecha_emision_sf
YYYY-MM-DD

Fecha de emision

fecha_traslado_sf
YYYY-MM-DD

Fecha de traslado

guia_modalidad_traslado_id
string

Modalidad de traslado (ver diccionario)

destinatario_id
string

Id generado automaticamente para cada cliente (manual)

partida_ubigeo
string

Id SUNAT del distrito

partida_direccion
string

Dirección completa de donde parte el envio

llegada_ubigeo
string

Id SUNAT del distrito

llegada_direccion
string

Dirección completa a la que llega el envio

notas
string

Notas del envio (no es indispensable)

codigo_tipo_destinatario
string

codigo_tipo_destinatario (ver diccionario)

numero_documento
string

Número de identificacion de la entidad

entidad
string

Nombre completo de la entidad

peso_total
string

Peso total del envio

numero_bultos
string

Número total de bultos enviados

numero_documento_transporte
string

Número de identificacion del conductor

entidad_transporte
string

Nombre completo de la entidad que transportara el envio

numero_mtc_transporte
string

Numero RUC de la empresa en la que se realiza el envio

conductor_dni
string

Número de identificacion del conductor

conductor_nombres
string

Nombres del conductor del transporte

conductor_apellidos
string

Apellidos del conductor del transporte

conductor_licencia
string

Numero de la licencia de conducir

vehiculo_placa
string

Placa del vehiculo en el que se realiza el envio

codigo_guia_modalidad_traslado
string

Codigo del traslado (ver diccionario)

detalles

Detalles del envio

codigo_unidad
string

Código de tipo de unidad de medida comercial (por defecto 1)

cantidad
string

Cantidad de productos

producto
string

Nombre del producto

producto_codigo
string

Código del producto (Codigo SUNAT)

Diccionario

serie

El número de serie es importante, ya que este forma parte del nombre de los archivos XML y tambien se envian a la SUNAT. Este puede variar, puede ser B001 o F001, dependiendo del tipo de boleta que se quiera enviar por guia de remision.

Tipo de comprobante electronicoserie
BoletaB001
FacturaF001

guia_modalidad_traslado_id

Para el tipo de pago de la venta es necesario especificar el tipo de este. A continuacion una tabla con el tipo de monedas disponibles

guia_modalidad_traslado_idtipo de transporte
01Público
02Privado

codigo_tipo_destinatario

En codigo_tipo_destinatario puede cambiar de acuerdo al al tipo de entidad a la que llegara la mercaderia.

codigo_tipo_destinatarioEntidad
1DNI
6RUC
0Empresas Del Extranjero - No Domiciliado
4CARNET DE EXTRANJERIA
7PASAPORTE
8Permiso Temporal de Permanencia - PTP

codigo_guia_modalidad_traslado

En codigo_guia_modalidad_traslado especifica el motivo del traslado.

codigo_guia_modalidad_trasladoCOD. GUIA MOTIVO DE TRASLADO
01Venta
14Venta sujeta a confirmación del comprador
02Venta sujeta a confirmación del comprador
04Traslado entre establecimiento de la misma empresa
18Traslado por emisor itinerante de comprobantes de pago
19Traslado zona primaria
08Importación
09Exportación
13Otras NO incluida en los puntos anteriores

¿Como conseguir el token?

Para conseguir el token requerido en las consultas a los endpoints disponibles, debe acceder a la seccion Obtener token para tener una informacion más detallada al respecto.


© 2024 FED | Todos los derechos reservados.
MODAS TEXTILES DRAGO S.A.C - RUC: 20608386387