> For the complete documentation index, see [llms.txt](https://quinodevelop.gitbook.io/billme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quinodevelop.gitbook.io/billme/uso-de-la-api/markdown/guia-de-remision.md).

# 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:

<mark style="color:green;">**`POST`**</mark> `https://www.api.billmeperu.com/api/v1/Emission/EnviarGuiaRemision`

### Request body

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

#### Objeto `emisor`

<table><thead><tr><th width="231">Nombre</th><th width="139">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de documento del emisor, para RUC el código es "6"</td></tr><tr><td>numDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Número de documento del emisor</td></tr><tr><td>razonSocial<mark style="color:red;">*</mark></td><td>string</td><td>Razón social del emisor</td></tr></tbody></table>

#### Objeto `cliente`

<table><thead><tr><th width="231">Nombre</th><th width="142">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de documento (RUC, DNI, etc)</td></tr><tr><td>numDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Número de documento del cliente</td></tr><tr><td>razonSocial<mark style="color:red;">*</mark></td><td>string</td><td>Razón Social o Nombre del cliente</td></tr></tbody></table>

#### Objeto `conductor`

<table><thead><tr><th width="246">Nombre</th><th width="141">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de documento (RUC, DNI, etc)</td></tr><tr><td>numeroDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Número de documento del conductor</td></tr><tr><td>nombres<mark style="color:red;">*</mark></td><td>string</td><td>Nombres del conductor</td></tr><tr><td>apellidos<mark style="color:red;">*</mark></td><td>string</td><td>Apellidos del conductor</td></tr><tr><td>licencia<mark style="color:red;">*</mark></td><td>string</td><td>Número de licencia del conductor, no debe contener guiones</td></tr></tbody></table>

#### Objeto `items`

<table><thead><tr><th width="249">Nombre</th><th width="136">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>cantidad<mark style="color:red;">*</mark></td><td>decimal</td><td>Cantidad de unidades del producto</td></tr><tr><td>codigoUnidad<mark style="color:red;">*</mark></td><td>string</td><td>Código de la <a href="/pages/UgciTjHoBWbwCbi3G2ZJ#tipo-de-unidad-de-medida">unidad </a>del producto</td></tr><tr><td>nombre<mark style="color:red;">*</mark></td><td>string</td><td>Nombre del producto</td></tr><tr><td>codigo<mark style="color:red;">*</mark></td><td>string</td><td>Código interno del producto</td></tr></tbody></table>

### Ejemplos

```json
{
    "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=="
}
```

{% hint style="info" %}
Los tipos de códigos los puedes encontrar en la sección "[Catálogo de códigos](/billme/uso-de-la-api/catalogo-de-codigos.md)"
{% endhint %}