End Point para Guías de Remisión
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ámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| token_contribuyente | string | Sí | El token único del contribuyente asignado por eFacturando. |
| id_usuario_vendedor | integer | Sí | ID del usuario vendedor en el sistema. |
| tipo_proceso | string | Sí | Entorno de envío. pruebaproduccion |
| tipo_envio | string | Sí | Tipo de envío del comprobante. inmediatoprogramado |
Parámetros: cabecera_comprobante
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_documento | string | Sí | Tipo de comprobante SUNAT. "09" = Guía de Remisión Remitente |
| idsucursal | integer | Sí | ID de la sucursal emisora configurada en tu cuenta. |
| fecha_comprobante | string | Sí | Fecha de emisión de la guía en formato DD/MM/YYYY. |
| motivo_traslado | string | Sí | Código SUNAT del motivo de traslado de los bienes. |
| modalidad_traslado | string | Sí | Código SUNAT de modalidad de traslado. |
| fecha_traslado | string | Sí | Fecha inicio de traslado en formato DD/MM/YYYY. |
| otro_motivo_traslado | string | No | Obligatorio sólo si el motivo de traslado es "Otros". |
| pesobruto | decimal | Sí | Peso bruto total de los bienes (en KGM). |
| numero_bultos | integer | Sí | Cantidad total de bultos o pallets. |
| numero_contenedor | string | No | Obligatorio en exportaciones, número de contenedor. |
| codigo_puerto | string | No | Obligatorio en exportaciones, código SUNAT del puerto. |
| tipo_doc_referencia | string | No | Tipo de comprobante relacionado (Ej. 01 para Factura). |
| serie_doc_referencia | string | No | Serie del documento de referencia. |
| numero_doc_referencia | string | No | Correlativo del documento de referencia. |
| informacion_adicional_sunat | string | No | Cualquier dato libre que se agregue a la representación impresa. |
| punto_llegada_local_anexo | string | No | Código del establecimiento anexo de llegada (si aplica). |
Parámetros: cliente
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_docidentidad | integer | Sí | Tipo de documento de identidad del destinatario. |
| numerodocumento | string | Sí | Número de documento del cliente (Ej: RUC o DNI). |
| nombre | string | Sí | Razón social o nombre completo del destinatario. |
| string | No | Correo electrónico para enviar la guía PDF. | |
| direccion | string | No | Dirección de facturación (no es de llegada). |
| ubigeo | string | No | Ubigeo de facturación de 6 dígitos. |
| sexo | string | No | M o F. Para estadísticas locales. |
| fecha_nac | string | No | DD/MM/YYYY. |
| celular | string | No | Celular para envío del comprobante por WhatsApp. |
Parámetros: transporte
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_docidentidad | string | Sí | Documento del conductor (traslado privado) o transportista (público). |
| numerodocumento | string | Sí | Número de identidad del transportista/conductor. |
| nombre | string | Sí | Nombre completo o Razón social del conductor/transportista. |
| num_placa | string | Sí | Número de placa del vehículo de transporte. |
| conductor_num_licencia | string | No | Obligatorio en traslado privado. Número de licencia de conducir. |
Parámetros: direccion_partida y direccion_llegada
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| direccion | string | Sí | Dirección completa y detallada del punto exacto. |
| ubigeo | string | Sí | Código INEI de ubigeo (6 dígitos). Es vital que coincida con el distrito. |
Parámetros: detalle (array de ítems)
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| idproducto | integer | Sí | ID interno del producto (usar 0 para manual). |
| codigo | string | Sí | Código interno. |
| descripcion | string | Sí | Descripción del bien. |
| idunidadmedida | string | Sí | Unidad SUNAT. Ej: NIU, KGM, BX. |
| peso | decimal | Sí | Peso unitario del ítem trasladado. |
| cantidad | decimal | Sí | Cantidad exacta del ítem. |