Interfaz de Programación de Aplicaciones (API)

Emisión de Guías de Remisión Remitente

Facturactiva
V1.3

Interfaz de Programación de Aplicaciones (API)

Guía Electrónica de Remisión del
Remitente
La API - Emisión de Documentos Electrónicos de Facturactiva es un WebService que recibe como
formato de input de datos: JSON (por lo cual requiere que toda petición que contenga un body
(peticiones POST, PUT, DELETE) especifique la cabecera HTTP “Content-Type” con el valor de
“application/json”).

Esquema de autenticación:

La autenticación de la API será usando el protocolo OAuth 2.0 haciendo uso de token de accesos,
los cuales son generados/intercambiados mediante un API_KEY y API_SECRET que son únicos por
cliente (entregados por Facturactiva).

Nomenclatura de representación de datos

En el cuadro siguiente se describe la nomenclatura de representación del formato de datos,

necesaria para una comprensión correcta de la descripción de campos.

a carácter alfabético
n carácter numérico
an carácter alfanumérico
a3 3 caracteres alfabéticos de longitud fija
n3 3 caracteres numéricos de longitud fija
an3 3 caracteres alfa-numéricos de longitud fija
a..3 hasta 3 caracteres alfabéticos
n..3 hasta 3 caracteres numéricos
an..3 hasta 3 caracteres alfa-numéricos
n(12,2) elemento numérico hasta 12 dígitos, 10 enteros+punto decimal+
hasta dos decimales
n(3,2) elemento numérico hasta 3 dígitos, 1 entero+punto decimal+
hasta dos decimales
F##### elemento inicia con la letra F seguida de cinco dígitos
B##### elemento inicia con la letra B seguida de cinco dígitos
YYYY-MM-DD formato fecha yyyy=año, mm=mes, dd=día
hh:mm:ss Formato hora hh=hora, mm= minuto, ss=segundo

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 1 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

Este documento hace uso y menciona los catálogos de códigos de SUNAT, los cuales pueden ser
descargados desde http://orientacion.sunat.gob.pe/index.php/empresas-menu/comprobantes-
de-pago-empresas/comprobantes-de-pago-electronicos-empresas/see-desde-los-sistemas-del-
contribuyente/2-comprobantes-que-se-pueden-emitir-desde-see-sistemas-del-
contribuyente/factura-electronica-desde-see-del-contribuyente/3552-normas-legales-factura-
electronica (Buscar Anexo 8 - catálogo de códigos principal) y
http://contenido.app.sunat.gob.pe/insc/ComprobantesDePago+Electronicos/Detalle+CATALOGO+
2,3,4+13.pdf (catálogo de códigos extras), estos documentos contienen los diferentes conceptos
de códigos mencionados en este documento.

Url base de API: http://api.emisores.facturactiva.com

Endpoint POST /oauth2/token

En esta ruta se obtiene el access token necesario para autenticarse en otros endpoints.

Pasos para obtener el access token:

1. Codificar su API_KEY y API_SECRET

Los pasos para codificar su API_KEY y API_SECRET en un conjunto de credenciales

para obtener un access token son:

a. Codificar de acuerdo a RFC 1738 (URL encode) los valores del API_KEY y
API_SECRET
b. Concatenar los valores del API_KEY codificada, el carácter “:”, y el API_SECRET
codificada en una sola cadena.
c. Codificar en Base64 la cadena obtenida del paso anterior.

A continuación, se muestran algunos ejemplos de los resultados obtenidos aplicando los

pasos anteriores.

API_KEY xvz1evFS4wEEPTGEFPHBog
API_SECRET L8qq9PZyRg6ieKGEKhZolGC0vJWLw8iEJ88
DRdyOg
Valor del API_KEY codificado según RFC xvz1evFS4wEEPTGEFPHBog
1738 (nótese que generalmente el valor
no cambia)
Valor del API_SECRET codificado según L8qq9PZyRg6ieKGEKhZolGC0vJWLw8iEJ88
RFC 1738 (nótese que generalmente el DRdyOg
valor no cambia)
Conjunto de credenciales obtenidas al xvz1evFS4wEEPTGEFPHBog:L8qq9PZyRg6ie
concatenar KGEKhZolGC0vJWLw8iEJ88DRdyOg
Conjunto de credenciales en base64 eHZ6MWV2RlM0d0VFUFRHRUZQSEJvZzpM
OHFxOVBaeVJnNmllS0dFS2hab2xHQzB2Sld
MdzhpRUo4OERSZHlPZw==

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 2 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

2. Obtener su access token

El valor calculado en el paso 1 debe ser cambiado por un token mediante una petición
POST a /oauth2/token.

 La petición debe ser HTTP POST

 La petición debe incluir un header de Authorization con el valor de: Basic <Valor
codificado en base64 del paso1>
 La petición debe incluir un header Content-Type con el valor de application/json
 El cuerpo de la petición debe ser: { grant_type: ‘client_credentials’ }
Ejemplo de petición:

 POST /oauth2/token HTTP/1.1

 Host: api.facturactiva.com
 User-Agent: Client Application
 Authorization: Basic
eHZ6MWV2RlM0d0VFUFRHRUZQSEJvZzpMOHFxOVBaeVJnNmllS0dFS2hab2xHQzB
2SldMdzhpRUo4OERSZHlPZw==
 Content-Type: application/json
 Content-Length: 29
Cada access_token generado es válido por 24 horas.

Si la petición fue realizada correctamente, el servidor responderá con un JSON igual a:

1. {
2. "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJGYWN0dXJhY3
RpdmEiLCJpYXQiOjE0NTc3MjM5NTYsImV4cCI6MTQ1NzgxMDM1NiwianRpIjoiYTM3OWZmNGI0OTdj
NDgwN2FlMDc1MThjYWYwNDIyMjAiLCJjb25zdW1lcktleSI6IjZYU2xOR09UamM0NXJnZU9WZzVPSU
0ifQ.imNmYCFuUBozqqgWcc0yz3UuC7GCp0ApahwOvayoqL8",
3. "expires_at": 1457810356,
4. "token_type": "Bearer"
5. }

Nota: A partir de este punto cualquier endpoint que contenga la glosa “(requiere
access token)” necesitara enviar su access token de la siguiente forma:
- El access token se deberá incluir en la petición usando el header Authorization con el
valor de: Bearer <Valor del access token>

Ejemplo de petición:

POST /documents HTTP/1.1

Host: api.facturactiva.com
User-Agent: Client Application
Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJGYWN0dXJhY3RpdmEiLCJpYXQiOjE
0NTc3MjM5NTYsImV4cCI6MTQ1NzgxMDM1NiwianRpIjoiYTM3OWZmNGI0OTdjNDgwN2

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 3 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

FlMDc1MThjYWYwNDIyMjAiLCJjb25zdW1lcktleSI6IjZYU2xOR09UamM0NXJnZU9WZzVP
SU0ifQ.imNmYCFuUBozqqgWcc0yz3UuC7GCp0ApahwOvayoqL8
{} // cuerpo de petición dependiendo del endpoint

Respuesta de cualquier endpoint (que requiera access token) en caso de autenticación inválida:

Cualquier endpoint que requiera autenticación responderá con el siguiente formato al detectar
una autenticación invalida (ya sea porque el token es invalido, o porque el token expiró).

1. {
2. "errors": [{
3. "status": 401,
4. "code": "10"
5. "detail": "Unauthorized"
6. }]
7. }

Nota: La longitud máxima de cualquier mensaje de error es de 500 caracteres, sin embargo en
ocasiones no controladas este campo podría contener una cantidad mayor de caracteres, es por
eso que se recomienda que de almacenar el mensaje siempre se trunque la cadena a 500
caracteres para evitar cualquier error no esperado.

status -> el código de respuesta http

code -> código de error Facturactiva (Ver tabla 11 códigos error Facturactiva)

detail -> mensaje de error

Dependiendo si el origen del error fue porque la autenticación falló o por que el token no tiene
autorización para realizar la acción, los posibles códigos http (según especifica los códigos estados
erróneos HTTP) de error de autenticación serán los siguientes:

 401 - Entregado cuando la autenticación falló, el token es inválido o ha expirado.

 403 - Entregado cuando la autenticación es correcta, pero el token no tiene los
permisos para realizar la acción.
Endpoint POST /emission/ documents(requiere access token)

En esta ruta se podrá enviar la información de un documento electrónico (Guía de Remisión del
Remitente) para ser declarado contra La Superintendencia Nacional de Aduanas y de
Administración Tributaria (SUNAT).

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 4 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

Representación general de cuerpo de petición:

1. {
2. "tipoDocumento": "09", // [Ver tabla 1 Catálogo No. 01 Anexo 8
SUNAT. Codigo de tipo de documento electronico para ver los posibles valores] –
String(2),
3. "idTransaccion": "0000001", // [Id unico por transaccion/emision de documento (Ej:
id de servicio, id de venta, etc)] – String(250),
4. "fechaEmision": "2017-09-10", // [Dato alfanumérico de 10 posiciones con formato
yyyy-mm-dd.]
5. "correoReceptor": "[email protected]", // (Campo opcional) [Correo electrónico
del receptor al cual se enviará una copia de las representaciones del comprobante
electrónico (XML, PDF), en caso de no especificar este campo se usará el correo
electrónico que el emisor previamente ha registrado en la sección de clientes del
portal facturactiva.] – String(260),
6. "documento": {Documento}, // [Ver tabla 6. Campos documento para una descripcion d
el formato de este objeto]
7. "guia": {Traslado}, // {Ver tabla 7. Campos guía para una descripción del formato
de este objeto}
8. "referencia": [{ referencia }], // {Ver tabla 9 Campos referencia
para una descripcion del formato de este arreglo}
9. "detalle": [{Detalle documento}], // [Ver tabla 10 Campos detalle documento
para una descripcion del formato de este arreglo]
10. }

Representación de respuesta satisfactoria.

En caso de comunicación satisfactoria, la respuesta de este endpoint será con código http 200 y el
formato de la respuesta será el siguiente.

1. "data": {
2. "tipoDocumento": "09",
3. "numComprobante": "T001-10000001",
4. "estadoEmision": "A",
5. "observaciones": []
6. }

Representación de respuesta en caso de errores:

En caso de error la respuesta será con código de error http (según especifica los códigos estados
erróneos HTTP, ya sean errores 4XX – Errores de cliente o 5XX – Errores del servidor, ej: 400, 500,
etc) y el formato de la respuesta será el siguiente:

1. {
2. "errors": [{
3. "status": 400,
4. "code": "51",
5. "detail": "Campo tipoDocEmisor no puede estar vacío",
6. "meta": {
7. "reenvioHabilitado": true
8. }
9. }]
10. }

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 5 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

Nota: La longitud máxima de cualquier mensaje de error es de 500 caracteres, sin embargo en
ocasiones no controladas este campo podría contener una cantidad mayor de caracteres, es por
eso que se recomienda que de almacenar el mensaje siempre se trunque la cadena a 500
caracteres para evitar cualquier error no esperado.

El campo errors es arreglo que contiene uno o más errores encontrados en la petición, el primer
error en este arreglo simboliza el error principal en la petición, dicho error principal es un objeto
que contiene la siguiente información:

status -> el código de respuesta http

detail -> mensaje de error
code -> código de error Facturactiva (Ver tabla 11 códigos error Facturactiva)

meta.codigoErrorSUNAT -> código de error principal SUNAT (este campo solo estará presente en
los casos que el error provenga desde SUNAT)

meta.estadoEmision -> Estado de emisión obtenido en él envió (este campo solo estará presente
en los casos donde el error provenga desde SUNAT, en los casos que el error provenga por una
validación de datos realizada antes de enviar los datos a SUNAT, este campo no estará presente)

Posibles valores del campo “estadoEmision” en una respuesta con errores:

 N
 R

meta.reenvioHabilitado -> valor booleano que indica si el documento puede ser re-enviado
utilizando la misma serie y correlativo, true en caso de permitir su re-envió o false en caso de no
ser posible un re-envió. Por ejemplo, en caso de recibir este campo como false al enviar una
factura, esto significaría que SUNAT ya no recibirá este comprobante con la misma serie y
correlativo, lo cual conllevaría a que el emisor revise por que la emisión del comprobante generó
el error, proceder a corregir el error, y finalmente emitir la operación generando un nuevo
correlativo. (este campo solo estará presente en los casos donde se tenga suficiente información
para determinar su valor, por lo que en los casos de no estar presente este campo, el emisor
deberá asumir que puede reenviar el documento con la misma serie y correlativo).

Los siguientes ítems (del segundo en adelante) en el arreglo errors son considerados errores
secundarios, los cuales son representados con un objeto que contiene la siguiente información:

code -> código de error Facturactiva (Ver tabla 11 códigos error Facturactiva)

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 6 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

detail -> mensaje de error

meta.codigoErrorSUNAT -> código de error secundario SUNAT (este campo solo estará presente
en los casos que el error provenga desde SUNAT)

Ejemplo de una respuesta errónea con varios errores (1 error principal, 1 error secundario):

1. {
2. "errors": [{
3. "status": 400,
4. "code": "51",
5. "detail": "Campo tipoDocEmisor no puede estar vacio"
6. }, {
7. "code": "52",
8. "detail": "Campo numCajero no está habilitado como campo adicional para este
emisor"
9. }]
10. }

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 7 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

ANEXO - TABLAS

1. Tabla de Código de tipo de documento electrónico:

Código
Descripción
01 Factura
03 Boleta de Venta
07 Nota de Crédito
08 Nota de Debito
09 Guía de Remisión del Remitente

2. Tabla de Código de tipo de documento de identidad:

Código Descripción
DOC.TRIB.NO.DOM.SIN.RUC
0
DOC. NACIONAL DE IDENTIDAD (DNI)
1
CARNET DE EXTRANJERIA
4
REG. UNICO DE CONTRIBUYENTES (RUC)
6
PASAPORTE
7
CED. DIPLOMATICA DE IDENTIDAD
A

3. Tabla de Código de documentos Relacionados

Código Descripción
NUMERACION DAM
01
NUMERO DE ORDEN DE ENTREGA
02
NUMERO SCOP
03
NUMERO DE MANIFIESTO DE CARGA
04
NUMERO DE CONSTANCIA DE DETRACCION
05
OTROS
06

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 8 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

4. Tabla de Motivo Traslado

Código Descripción
VENTA
01
VENTA SUJETA A CONFIRMACION DEL COMPRADOR
14
COMPRA
02
TRASLADO ENTRE ESTABLECIMIENTOS DE LA MISMA
04
EMPRESA
TRASLADO EMISOR ITINERANTE CP
18
IMPORTACION
08
EXPORTACION
09
TRASLADO A ZONA PRIMARIA
19
OTROS
13
5. Tabla de Modalidad Traslado

Código Descripción
TRANSPORTE PÚBLICO
01
TRANSPORTE PRIVADO
02

6. Tabla Campos “documento”:

Campo Descripción Tipo de Formato Obligatorio/ Ejemplo

dato Condicional
serie Código de serie String(4) an..4 Habilitado: serie: 'T001'
del documento ☒
utilizado para Obligatorio
guía de remisión ☒
T###

correlativo Número Integer n..8 Habilitado: correlativo: 108

correlativo del ☒
documento Obligatorio
☒
sustento Observaciones String(250) an..250 Habilitado: sustento: 'Traslado de
para describir el ☒ equipos de cómputo'
traslado (este Obligatorio
campo no es un ☒
dato que SUNAT
exija, solo es
usado para los
reportes de los
documentos
electrónicos)
tipoDocEmisor Tipo de String(2) an..2 Habilitado: tipoDocEmisor: '6'
documento ☒
identidad del Obligatorio
emisor (Ver

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 9 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

tabla 2) ☒
numDocEmisor Número de String(25) n..25 Habilitado: numDocEmisor: '205
identidad del ☒ 18915119'
emisor Obligatorio
☒
nombreEmisor Apellidos y String(100) an..100 Habilitado: nombreEmisor: 'MINE
nombres o ☒ RIA CORPORATIVA S.A
denominación o Obligatorio .C.'
razón social ☒

tipoDocRecepto Tipo de String(2) an..2 Habilitado: tipoDocReceptor: '6'

r documento ☒
identidad (Ver Obligatorio
tabla 2) ☒
numDocRecept Número de String(25) an..25 Habilitado: numDocReceptor
or documento de ☒ : '20518915119'
identidad Obligatorio
☒

nombreRecepto Apellidos y String(100) an..100 Habilitado: nombreReceptor:

r nombres o ☒ 'TAM
denominación o Obligatorio CONSULTORES'
razón social ☒

tipoFormatoRep Código del tipo String(100) an..100 Habilitado: tipoFormatoRe

resentacionImpr de formato de ☒ presentacionIm
esa representación Obligatorio: presa: 'GENERAL'
impresa a usar ☐
para el
comprobante.
De no enviar
este campo se
usará por
defecto el
formato
“GENERAL”

7. Tabla Campos “guia”

Campo Descripción Tipo de dato Formato Obligatorio/ Ejemplo

Condicional
horaEmision Corresponde String(12) an..12 Habilitado: horaEmision :
a la hora de ☒ '10:05:00'
emisión que Obligatorio:
se presente ☒
la GUIA en la
SUNAT.
hh:mm:ss.oz
ó 'hh:mm:ss
codigoMotivoTrasla Motivo del String(2) an2 Habilitado: codigoMotivoTrasla
do traslado (Ver ☒ do: '01'
tabla 4) Obligatorio:
Catálogo No. ☒
20 Anexo 8
SUNAT
motivoTraslado Descripción String(100) an..100 Habilitado: motivoTraslado:
de motivo de ☒ ‘VENTA'
traslado Obligatorio:
☐

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 10 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

esTransbordoProgr Indicador de Boolean Habilitado: esTransbordoProgr

amado Transbordo ☒ amado: false
Programado. Obligatorio:
☒
Tratándose
de
transbordo
programado,
esta
información
se deberá
consignar
por cada
tramo.
totalPesoBrutoTran Peso bruto Decimal(10, n(10, 4) Habilitado: totalPesoBrutoTran
sportado total de los 4) ☒ sportado: 36.25
bienes. Obligatorio:
☒
unidadMedidaPeso Unidad de String(3) an..3 Habilitado: unidadMedidaPeso
Transportado medida del ☒ Transportado:
peso bruto Obligatorio: 'KGM'
de los bienes ☒
trasladados
por ítem.
Catalogo 3 –
Anexo 8
SUNAT.

cantidadUnitariaTr Número de Decimal(10, n(10, 4) Habilitado: cantidadUnitariaTr

ansportado Bulltos o 4) ☒ ansportado: 5
Pallets Obligatorio:
☐
codigoModalidadTr Modalidad String(2) an..2 Habilitado: codigoModalidadTr
ansporte de Traslado ☒ ansporte:'02'
(ver tabla 4) Obligatorio:
Catalogo 18– ☒
Anexo 8
SUNAT.

fechaInicioTraslad Fecha de String(10) an..10 Obligatorio: ☒ fechaInicioTraslado

o inicio del (YYYY- : '2017-09-10'
traslado MM-DD) Condicional:
☒
direccionOrigenUbi Ubigeo del String(6) an..6 Habilitado: direccionOrigenUbi
geo punto de ☒ geo: '120606'
partida. Obligatorio:
Según ☒
catálogo N°
13 del Anexo
N° 8
direccionOrigenDe Nombre del String(50) an .. 50 Habilitado: direccionOrigenDep
partamento departament ☒ artamento: 'JUNIN'
o del punto Obligatorio:
de partida ☐
direccionOrigenPro Nombre de la String(50) an .. 50 Habilitado: direccionOrigenPro
vincia provincia del ☒ vincia: 'SATIPO'
punto de Obligatorio:
partida ☐
direccionOrigenDis Nombre del String(50) an .. 50 Habilitado: direccionOrigenDist
trito distrito del ☒ rito: 'PANGOA'
punto de Obligatorio:
partida ☐
direccionOrigen Dirección del String(100) an..100 Habilitado: direccionOrigen:
punto de ☒ 'CALLE LOS PINOS
partida Obligatorio: N°4780 '

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 11 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

☒
direccionDestinoU Ubigeo del String(6) an..6 Habilitado: direccionDestinoUb
bigeo punto de ☒ igeo: '150123'
llegada. Obligatorio:
Según ☒
catálogo N°
13 del Anexo
N° 8
direccionDestinoD Nombre del String(50) an .. 50 Habilitado: direccionDestinoDe
epartamento departament ☒ partamento: 'LIMA'
o del punto Obligatorio:
de destino ☐
direccionDestinoPr Nombre de la String(50) an .. 50 Habilitado: direccionDestinoPr
ovincia provincia del ☒ ovincia: 'LIMA'
punto de Obligatorio:
destino ☐
direccionDestinoDi Nombre del String(50) an .. 50 Habilitado: direccionDestinoDi
strito distrito del ☒ strito:
punto de Obligatorio: 'PACHACAMAC'
destino ☐
direccionDestino Dirección del String(100) an..100 Habilitado: direccionDestino:
punto de ☒ 'CALLE LOS
destino Obligatorio: ROBLES N°4780'
☒
codigoPuerto Código del String(10) an..10 Habilitado: codigoPuerto: 'PAI'
Puerto. ☒
Puerto o Obligatorio:
Aeropuerto ☐
de
embarque/d
esembarque
cuando el
motivo de
traslado es
importación
numeroContenedor Datos del String(10) an..10 Habilitado: numeroContenedo:
contenedor ☒ 'I789000'
(Obligatorio Obligatorio:
si motivo es ☐
Importación)
nombreTransportis Apellidos y String(100) an..100 Habilitado: nombreTransportist
ta Nombres o ☒ a: 'TRANSPORTE
denominació Obligatorio: S.A.C.'
n o razón ☐
social del
transportista
tipoDocumentoTra Tipo de String(2) an..2 Habilitado: tipoDocumentoTra
nsportista documento ☒ nsportista: '6'
del Obligatorio:
transportista. ☐
(Ver tabla 2)

Si la Guía de
remisión
remitente
cuenta con la
información
requerida al
transportista
sobre el
vehículo que
realiza el
traslado y
sus
conductores

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 12 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

en caso de
transporte
público, el
transportista
ya no
requerirá
llenar su guía
de remisión
transportista
(Normativa
General
sobre Guiase
Electrónicas)
. Cuando
utilice los
servicios de
un
transportista
(modalidad
de traslado:
transporte
público) y
siempre que
el
transportista
emita su guía
de remisión
transportista
o su factura
electrónica
transportista,
en
reemplazo
de estos
datos, se
deberá
consignar
solo la
información
señalada en
las casillas
rucTransporti
sta y
nombreTrans
portista.

numeroDocumento Numero de String(25) an..25 Habilitado: numeroDocumento

Transportista RUC ☒ Transportista:
transportista Obligatorio: '20145875210'
☐
tipoDocumentoCho Tipo de String(2) an..2 Habilitado: tipoDocumentoCho
fer documento ☒ fer: '1'
de identidad Obligatorio:
del ☐
conductor ,
tratándose
de
Transporte
Privado
(Ver tabla 2).
Todos menos
RUC

numeroDocumento Número de String(25) an..25 Habilitado: numeroDocumento

Chofer documento ☒ Chofer: '72715963'
de identidad Obligatorio:
del

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 13 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

conductor. ☐
nombreChofer Nombre o String(100) an..100 Habilitado: nombreChofer:
razón social ☒ 'Jose Martin Paz
del Obligatorio: Urquia'
conductor ☐
tipoDocumentoPro Tipo de String(2) an..2 Habilitado: tipoDocumentoProv
veedor documento ☒ eedor: '6'
identidad Obligatorio:
(Ver tabla 2) ☐
catálogo N.°
6 del Anexo
N.°8 Sunat

Se ingresa
esta
información
cuando el
motivo
traslado sea
COMPRA,
TRASLADO
ENTRE
ESTABLECIMIE
NTOS DE LA
MISMA
EMPRESA,
IMPORTACION

numeroDocumento Número de String(25) an..25 Habilitado: numeroDocumento

Proveedor documento ☒ Proveedor: '20518
de identidad Obligatorio: 915119'
☐
nombreProveedor Apellidos y String(100) an..100 Habilitado: nombreProveedor:
nombres o ☒ 'TAM
denominació Obligatorio: CONSULTORES’
n o razón ☐
social

placaTransporte Número de String(15) an..15 Habilitado: placaTransporte:

placa del ☒ 'TOT-477.'
vehículo Obligatorio:
☐

8. Tabla Campos “referencia”

Campo Descripción Tipo de Formato Obligatorio/ Ejemplo

dato Condicional
tipoDocumento Tipo Documento String(2) an2 Habilitado: tipoDocumentoRef: 0
Ref Relacionado a la ☒ 3
Guía de Obligatorio:
Remisión (Ver ☐
tabla 3)
Catálogo No. 21
Anexo 8 SUNAT
serieRef Código de serie String(4) an4 Habilitado: serieRef: 'RG01'
del documento ☒
relacionado Obligatorio:
☐
correlativoRef Número Integer n..8 Habilitado: correlativoRef: 108
correlativo del ☒
documento Obligatorio:
relacionado ☐
fechaEmisionRe Fecha de Date YYYY- Habilitado: fechaEmisionRef: '20
f emisión del MM-DD ☒
documento

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 14 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

afectado. Obligatorio: 17-10-02'

☐

9. Tabla Campos “detalle”

Campo Descripción Tipo de Formato Obligatorio/ Ejemplo

dato Condicional
cantidadItem Cantidad de Integer n..8 Habilitado: cantidadItem: 50
unidades ☒
vendidas por Obligatorio:
ítem. ☐
unidadMedidaIt Unidad de String(3) an..3 Habilitado: unidadMedidaItem: 'B
em medida de los ☒ X'
bienes Obligatorio:
trasladados por ☐
ítem. Catalogo 3
– Anexo 8
SUNAT.
nombreItem Descripción String(250) an..250 Habilitado: nombreItem: 'CAJAS'
detallada del ☒
item Obligatorio:
☐
codItem Codigo del item String(16) an..16 Habilitado: codItem: 'C005'
☒
Obligatorio:
☐
idOperacion Id de la String(80) an..80 Habilitado: idOperacion: '6781'
operación ☒
asociada a este Obligatorio:
comprobante ☐
electrónico

10. Tabla de Códigos de error Facturactiva:

Lista de errores específicos de la suite Facturactiva. (De recibir un código de error no listado
en esta lista, usar el campo “status” en su objeto de error para determinar la mejor forma de
manejarlo.

Código (Max 4 caracteres) Descripción

10 Error de autenticación (credenciales invalidas o no
existentes)
11 Error de autorización (permisos)
12 Cuenta suspendida
13 Uso de servicio bloqueado por abuso
14 Límite de consultas en el periodo de tiempo superadas
(Rate Limit)
31 Sujeto invalido o no existente
32 Configuración necesaria para completar operación en
servicio está incompleta.
33 Credenciales necesarias para completar operación en
servicio no existen.
34 Certificados digital necesarios para completar operación
en servicio no existen.

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 15 de 16

 Interfaz de Programación de Aplicaciones (API)
Emisión de Guías de Remisión Remitente
Facturactiva
V1.3

35 Certificados digital necesarios para completar operación

en servicio han expirado.
49 Método/Modalidad no implementada
50 No se encontró ningún recurso con los datos enviados.
51 Validación de datos fallo al tratar de realizar operación
en servicio.
52 Validación de datos adicionales (personalizados) fallo al
tratar de realizar operación en servicio.
70 Error de duplicidad al tratar de procesar esta operación
(Operación no única).
71 La operación está en estado pendiente de
procesamiento.
72 Error retornado por entidad externa (Ej: Error retornado
por SUNAT, etc)
90 Error interno desconocido en la suite

Código: ARP-01.01.16 Dirección de Proyectos de Tecnologías de Información Página 16 de 16