End Point para Guías de Remisión

POST https://emisor.pe/facturacionv9/api/procesar_guia_remision
Request
Transporte Privado
Transporte Público
{
    "contribuyente":{
        "token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
        "id_usuario_vendedor":2,
        "tipo_proceso":"prueba",
        "tipo_envio":"inmediato"
    },
    "cabecera_comprobante":{
        "tipo_documento":"09",
        "idsucursal":691,
        "fecha_comprobante":"19/05/2026",
        "motivo_traslado":"01",
        "modalidad_traslado":"02",
        "fecha_traslado":"19/05/2026",
        "otro_motivo_traslado":"",
        "pesobruto":50,
        "numero_bultos":2,
        "numero_contenedor":"",
        "codigo_puerto":"",
        "tipo_doc_referencia":"",
        "serie_doc_referencia":"",
        "numero_doc_referencia":"",
        "informacion_adicional_sunat":"",
        "punto_llegada_local_anexo":""
    },
    "cliente":{
        "tipo_docidentidad":6,
        "numerodocumento":"20604209987",
        "nombre":"Razón social de tu cliente",
        "email":"email_cliente@gmail.com",
        "direccion":"",
        "ubigeo":"",
        "sexo":"",
        "fecha_nac":"",
        "celular":""
    },
    "transporte":{
        "tipo_docidentidad":"1",
        "numerodocumento":"42719520",
        "nombre":"José Luis Núñez-Melgar Vega",
        "num_placa":"ARG-678",
        "conductor_num_licencia":"Q42719520"
    },
    "direccion_partida":{
        "direccion":"Ca. Los Robles 231, San Isidro",
        "ubigeo":"150131"
    },
    "direccion_llegada":{
        "direccion":"Jr. Huancavelica 543, Lima",
        "ubigeo":"150101"
    },
    "detalle":[
        {
            "idproducto":0,
            "codigo":"TV_CODIGOPROD2",
            "descripcion":"Producto de Ejemplo",
            "idunidadmedida":"7",
            "peso":78.56,
            "cantidad":2.9
        },
        {
            "idproducto":0,
            "codigo":"TV_CODIGOPROD2",
            "descripcion":"Producto de Ejemplo",
            "idunidadmedida":"7",
            "peso":78.56,
            "cantidad":2.9
        }
    ]
}
{
    "contribuyente":{
        "token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
        "id_usuario_vendedor":2,
        "tipo_proceso":"prueba",
        "tipo_envio":"inmediato"
    },
    "cabecera_comprobante":{
        "tipo_documento":"09",
        "idsucursal":691,
        "fecha_comprobante":"19/05/2026",
        "motivo_traslado":"01",
        "modalidad_traslado":"01",
        "fecha_traslado":"19/05/2026",
        "otro_motivo_traslado":"",
        "pesobruto":50,
        "numero_bultos":2,
        "numero_contenedor":"",
        "codigo_puerto":"",
        "tipo_doc_referencia":"",
        "serie_doc_referencia":"",
        "numero_doc_referencia":"",
        "informacion_adicional_sunat":"",
        "punto_llegada_local_anexo":""
    },
    "cliente":{
        "tipo_docidentidad":6,
        "numerodocumento":"20604209987",
        "nombre":"Razón social de tu cliente",
        "email":"email_cliente@gmail.com",
        "direccion":"",
        "ubigeo":"",
        "sexo":"",
        "fecha_nac":"",
        "celular":""
    },
    "transporte":{
        "tipo_docidentidad":"6",
        "numerodocumento":"20135414931",
        "nombre":"Oltursa",
        "num_placa":""
    },
    "direccion_partida":{
        "direccion":"Ca. Los Robles 231, San Isidro",
        "ubigeo":"150131"
    },
    "direccion_llegada":{
        "direccion":"Jr. Huancavelica 543, Lima",
        "ubigeo":"150101"
    },
    "detalle":[
        {
            "idproducto":0,
            "codigo":"TV_CODIGOPROD2",
            "descripcion":"Producto de Ejemplo",
            "idunidadmedida":"7",
            "peso":78.56,
            "cantidad":2.9
        },
        {
            "idproducto":0,
            "codigo":"TV_CODIGOPROD2",
            "descripcion":"Producto de Ejemplo",
            "idunidadmedida":"7",
            "peso":78.56,
            "cantidad":2.9
        }
    ]
}
Response
Respuesta JSON
{
    "respuesta": "error",
    "titulo": "Error en API",
    "documento": {
        "respuesta": "ok",
        "id_contribuyente": 2,
        "id_tipodoc_electronico": "09",
        "serie_comprobante": "T002",
        "numero_comprobante": 4,
        "tipo_envio_sunat": "prueba"
    },
    "mensaje": "Se guardó correctamente en la base de datos, <span class=\"text-danger\">sin embargo no se logró enviar correctamente a Sunat, el documento se guardó como pendiente de envío a SUNAT</span>",
    "repuesta_api": "El Documento N°: T002-4, se guardó correctamente. <br /> Sin embargo no se logró enviar a SUNAT, nosotros recomendamos verificar el estado del documento!<br /><br /> ERROR: Las guías de remisión no se pueden generar en un ambiente de prueba",
    "resp_email": "202
Array
(
    [0] => HTTP/1.1 202 Accepted
    [1] => Date: Tue, 19 May 2026 18:13:09 GMT
    [2] => Content-Length: 0
    [3] => Connection: keep-alive
    [4] => Server: nginx
    [5] => X-Message-Id: pOGFpJ2uTMu_DqXrVBSqvA
    [6] => Access-Control-Allow-Origin: https://sendgrid.api-docs.io
    [7] => Access-Control-Allow-Methods: POST
    [8] => Access-Control-Allow-Headers: Authorization, Content-Type, On-behalf-of, x-sg-elas-acl
    [9] => Access-Control-Max-Age: 600
    [10] => X-No-CORS-Reason: https://sendgrid.com/docs/Classroom/Basics/API/cors.html
    [11] => Strict-Transport-Security: max-age=31536000; includeSubDomains
    [12] => Content-Security-Policy: frame-ancestors 'none'
    [13] => Cache-Control: no-cache
    [14] => X-Content-Type-Options: no-sniff
    [15] => Referrer-Policy: strict-origin-when-cross-origin
    [16] => 
    [17] => 
)

null"
}
⚠️
¡Importante sobre Serie y Correlativo!

Los comprobantes que se emiten no llevan en el request la serie ni el correlativo, ya que esto se configura y autogestiona automáticamente desde la sucursal del sistema.

Si tu sistema local necesita conocer qué número correlativo se asignará al comprobante antes de emitirlo (para evitar desfases de numeración en tu base de datos local), debes realizar una consulta previa.

Para ver el flujo de consulta, parámetros del request y ejemplos de respuesta, revisa la sección dedicada: Guía de Comprobar Correlativo 🔍.

Parámetros: contribuyente

ParámetroTipoReq.Descripción
token_contribuyentestringEl token único del contribuyente asignado por eFacturando.
id_usuario_vendedorintegerID del usuario vendedor en el sistema.
tipo_procesostringEntorno de envío.
pruebaproduccion
tipo_enviostringTipo de envío del comprobante.
inmediatoprogramado

Parámetros: cabecera_comprobante

ParámetroTipoReq.Descripción
tipo_documento
stringTipo de comprobante SUNAT.
"09" = Guía de Remisión Remitente
idsucursalintegerID de la sucursal emisora configurada en tu cuenta.
fecha_comprobantestringFecha de emisión de la guía en formato DD/MM/YYYY.
motivo_traslado
stringCódigo SUNAT del motivo de traslado de los bienes.
modalidad_traslado
stringCódigo SUNAT de modalidad de traslado.
fecha_trasladostringFecha inicio de traslado en formato DD/MM/YYYY.
otro_motivo_trasladostringNoObligatorio sólo si el motivo de traslado es "Otros".
pesobrutodecimalPeso bruto total de los bienes (en KGM).
numero_bultosintegerCantidad total de bultos o pallets.
numero_contenedorstringNoObligatorio en exportaciones, número de contenedor.
codigo_puerto
stringNoObligatorio en exportaciones, código SUNAT del puerto.
tipo_doc_referencia
stringNoTipo de comprobante relacionado (Ej. 01 para Factura).
serie_doc_referenciastringNoSerie del documento de referencia.
numero_doc_referenciastringNoCorrelativo del documento de referencia.
informacion_adicional_sunatstringNoCualquier dato libre que se agregue a la representación impresa.
punto_llegada_local_anexostringNoCódigo del establecimiento anexo de llegada (si aplica).

Parámetros: cliente

ParámetroTipoReq.Descripción
tipo_docidentidad
integerTipo de documento de identidad del destinatario.
numerodocumentostringNúmero de documento del cliente (Ej: RUC o DNI).
nombrestringRazón social o nombre completo del destinatario.
emailstringNoCorreo electrónico para enviar la guía PDF.
direccionstringNoDirección de facturación (no es de llegada).
ubigeo
stringNoUbigeo de facturación de 6 dígitos.
sexostringNoM o F. Para estadísticas locales.
fecha_nacstringNoDD/MM/YYYY.
celularstringNoCelular para envío del comprobante por WhatsApp.

Parámetros: transporte

ParámetroTipoReq.Descripción
tipo_docidentidad
stringDocumento del conductor (traslado privado) o transportista (público).
numerodocumentostringNúmero de identidad del transportista/conductor.
nombrestringNombre completo o Razón social del conductor/transportista.
num_placastringNúmero de placa del vehículo de transporte.
conductor_num_licenciastringNoObligatorio en traslado privado. Número de licencia de conducir.

Parámetros: direccion_partida y direccion_llegada

ParámetroTipoReq.Descripción
direccionstringDirección completa y detallada del punto exacto.
ubigeo
stringCódigo INEI de ubigeo (6 dígitos). Es vital que coincida con el distrito.

Parámetros: detalle (array de ítems)

ParámetroTipoReq.Descripción
idproductointegerID interno del producto (usar 0 para manual).
codigostringCódigo interno.
descripcionstringDescripción del bien.
idunidadmedida
stringUnidad SUNAT. Ej: NIU, KGM, BX.
pesodecimalPeso unitario del ítem trasladado.
cantidaddecimalCantidad exacta del ítem.
Catálogo