Guía de Remisión

Para el envío de emisiones de Guías de Remisión debes incluir los siguientes valores en el request:

POST https://www.api.billmeperu.com/api/v1/Emission/EnviarGuiaRemision

Request body

Nombre	Tipo	Descripción
codigoTipoDocumento*	string	Identificador del tipo de comprobante, por defecto es "09"
serie*	string	Código de serie del comprobante
correlativo*	string	Número correlativo del comprobante
fechaEmision*	string	Fecha en la que se realiza la emisión, debe estar en formato YYYY-MM-DD
horaEmision*	string	Hora en la que se realiza la emisión, si lo desea puede ser por defecto "00:00:00"
fechaEnvio*	string	Fecha en la que se envían los productos, debe estar en formato YYYY-MM-DD
nota	string	texto descriptivo de alguna nota adicional en caso se requiera
codigoMotivoTraslado*	string	Código del motivo de traslado
motivoTraslado*	string	Descripción corta del motivo del traslado
unidadPeso*	string	Siglas de la unidad del peso de los productos trasladados
peso*	decimal	Valor del peso total de los productos o carga trasladada
codigoTipoTransporte*	decimal	Código del tipo de traslado, si es público será "01" y si es privado será "02"
placaVehiculo*	decimal	Número de la placa del vehículo sin guiones
ubigeoOrigen*	string	Ubigeo de la dirección de origen
ubigeoDestino*	string	Ubigeo de la dirección de destino
direccionOrigen*	string	Dirección inicial del trayecto
direccionDestino*	string	Dirección final del trayecto
clientId*	string	Valor del ID de cliente generado en portal de SUNAT
clientSecret*	string	Valor del secret de cliente generado en portal de SUNAT
emisor*	object	Datos del emisor
cliente*	object	Datos del cliente
conductor	object	Datos del conductor, necesario sólo en caso el tipo de transporte sea privado
items*	object	Listado de los items transportados

Objeto emisor

Nombre	Tipo	Descripción
codigoTipoDocumento*	string	Código del tipo de documento del emisor, para RUC el código es "6"
numDocumento*	string	Número de documento del emisor
razonSocial*	string	Razón social del emisor

Objeto cliente

Nombre	Tipo	Descripción
codigoTipoDocumento*	string	Código del tipo de documento (RUC, DNI, etc)
numDocumento*	string	Número de documento del cliente
razonSocial*	string	Razón Social o Nombre del cliente

Objeto conductor

Nombre	Tipo	Descripción
codigoTipoDocumento*	string	Código del tipo de documento (RUC, DNI, etc)
numeroDocumento*	string	Número de documento del conductor
nombres*	string	Nombres del conductor
apellidos*	string	Apellidos del conductor
licencia*	string	Número de licencia del conductor, no debe contener guiones

Objeto items

Nombre	Tipo	Descripción
cantidad*	decimal	Cantidad de unidades del producto
codigoUnidad*	string	Código de la unidad del producto
nombre*	string	Nombre del producto
codigo*	string	Código interno del producto

Ejemplos

{
    "codigoTipoDocumento": "09",
    "serie": "T002",
    "correlativo": "2341",
    "fechaEmision": "2024-09-03",
    "horaEmision": "00:00:00",
    "fechaEnvio": "2024-09-03",
    "nota": "---",
    "codigoMotivoTraslado": "01",
    "motivoTraslado": "venta",
    "unidadPeso": "KGM",
    "peso": 5000,
    "codigoTipoTransporte": "01",
    "transportista": {
        "tipoDocumento": "6",
        "numeroDocumento": "20602323454",
        "nombre": "EL VIAJERO SAC"
    },
    "placaVehiculo": "M1X328",
    "conductor": {
        "codigoTipoDocumento": "1",
        "numeroDocumento": "12345678",
        "Nombres": "JOSE",
        "Apellidos": "JOSE",
        "Licencia": "C12345678"
    },
    "emisor": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20607599727",
        "razonSocial": "emisor de prueba"
    },
    "cliente": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20605145648",
        "razonSocial": "cliente de prueba"
    },
    "items": [
        {
            "codigo": "3123",
            "cantidad": 3,
            "codigoUnidad": "NIU",
            "nombre": "item1"
        },
        {
            "codigo": "4331",
            "cantidad": 2,
            "codigoUnidad": "NIU",
            "nombre": "item2"
        }
    ],
    "ubigeoOrigen": "140101",
    "ubigeoDestino": "140103",
    "direccionOrigen": "MI ORIGEN 123 - LAMBAYEQUE",
    "direccionDestino": "MI DESTINO 456 - MORROPE",
    "clientId": "test-85e5b0ae-255c-4891-a595-0b98c65c9854",
    "clientSecret": "test-Hty/M6QshYvPgItX2P0+Kw=="
}

Los tipos de códigos los puedes encontrar en la sección "Catálogo de códigos"