API Facturación Electrónica

EL servicio RESTful, permite crear Guías de Remisión Electrónicas (GRE), cumpliendo así con la normatividad establecida por SUNAT evitando multas a los contribuyentes. Para emitir una GRE se necesita generar el client_id y client_secret en el portal de sunat con la clave sol principal.

Guías de Remisión Electrónicas - GRE

Se debe tener en cuenta el archivo de ValidacionesGREv20241202.xslx publicado en el portal de SUNAT

Catálogo 18: Código de modalidad de transporte

Código Descripción
01 Transporte público
02 Transporte privado

Catálogo 20: Código de motivo de traslado

Código Descripción
01 Venta
02 Compra
03 Venta con entrega a terceros
04 Traslado entre establecimientos de la misma empresa
05 Consignación
06 Devolución
07 Recojo de bienes transformados
08 Importación
09 Exportación
13 Otros
14 Venta sujeta a confirmación del comprador
17 Traslado de bienes para transformación
18 Traslado emisor itinerante CP
19 Traslado de mercancía extranjera

Para crear una GRE, se deben configurar las cabeceras y asignar el token previamente generado durante la autentificación, luego se debe realizar una solicitud de request tipo POST. Si el token es válido, el Api Rest devolverá el xml de la GRE con su respectivo ticket para posteriormente descargar el Cdr que finalmente es un archivo XML que contiene la respuesta de sunat si nuestra GRE fue eceptada o no y un link que se usará para crear el QrCode.

Tabla de Indicadores GRE

Código Descripción
1 SUNAT_Envio_IndicadorTransbordoProgramado
2 SUNAT_Envio_IndicadorTrasladoVehiculoM1L
3 SUNAT_Envio_IndicadorRetornoVehiculoEnvaseVacio
4 SUNAT_Envio_IndicadorRetornoVehiculoVacio
5 SUNAT_Envio_IndicadorTrasladoTotalDAMoDS
6 SUNAT_Envio_IndicadorVehiculoConductoresTransp
7 SUNAT_Envio_IndicadorTrasporteSubcontratado
8 SUNAT_Envio_IndicadorPagadorFlete_Remitente
9 SUNAT_Envio_IndicadorPagadorFlete_Subcontratador
10 SUNAT_Envio_IndicadorPagadorFlete_Tercero
11 SUNAT_Envio_IndicadorTrasladoTotal

Tipos de GRE
Exsiten 2 tipos de GRE:

  • 1. Guía de Remisión Remitente: Debe usar el código 09 para indicar que es guía de remisión remitente y la serie debe empezar con T.
  • 2. Guía de Remisión Transportista: Debe usar el código 31 para indicar que es guía de remisión transportista y la serie debe empezar con V.

Headers
Authorization: Bearer + token
Content-Type: application/json 

End Point
https://apirest.tecnosolutionsperu.com/api/v1/gre

Guía de Remisión Remitente

{
    "documento": {
        "tipo_guia": "09",
        "serie": "TG01",
        "numero": "00000001",
        "fecha_emision": "2025-03-21",
        "hora_emision": "10:43:48",
        "nota": null
    },
    "emisor": {
        "tipo": 6,
        "numero": "20187001839",
        "razon_social": "REPRESENTACIONES PEPITO E.I.R.L.",
        "direccion": "CAL.JUAN CUGLIEVAN NRO. 1379 INT. A CERCADO DE CHICLAYO LAMBAYEQUE - CHICLAYO - CHICLAYO"
    },
    "cliente": {
        "tipo": "6",
        "numero": "20109065611",
        "razon_social": "CONSTRUCCION Y ADMINISTRACION DEL NORTE PERU S.A."
    },
    "documento_referencia": [],
    "tercero": [],
    "envio": {
        "codigo_traslado": "01",
        "descripcion_traslado": "VENTA",
        "peso_bruto": "35.00",
        "unidad_medida": "KGM",
        "numero_bultos": 0,
        "indicadorUno": null,
        "indicadorDos": null,
        "indicadorTres": null,
        "indicadorCuatro": 4,
        "indicadorCinco": null,
        "modo_transporte": "02",
        "fecha_traslado": "2025-03-17",
        "transportista": [],
        "conductores": [
            {
                "tipo_documento": "1",
                "numero": "16700281",
                "nombres": "MANUEL",
                "apellidos": "VILLANUEVA MERA",
                "tipo": "Principal",
                "licencia": "C16333281"
            }
        ],
        "llegada": {
            "ubigeo": "130702",
            "ruc": "20109565017",
            "direccion": "AV. NILA CERRUTI NRO. 290"
        },
        "partida": {
            "ubigeo": "140101",
            "ruc": "20487911829",
            "direccion": "CAL.JUAN CUGLIEVAN NRO. 1379 INT. A CERCADO DE CHICLAYO LAMBAYEQUE - CHICLAYO - CHICLAYO"
        },
        "vehiculo": {
            "placa": "C4C2928"
        }
    },
    "items": [
        {
            "id": 1,
            "codigo": "PRO00930",
            "descripcion": "ENVASE DELI 1 LT TR PET SUPER FAST CAJA",
            "unidad": "MIL",
            "cantidad": 3.5
        },
        {
            "id": 2,
            "codigo": "PRO02046",
            "descripcion": "TAPA DELI 1 LT D2 SUPER FAST TR PP",
            "unidad": "MIL",
            "cantidad": 3.5
        }
    ]
}

Respuesta Ticket

{
    "success": true,
    "data": {
        "filename": "20607006521-09-TG01-00000001",
        "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iaXNvLTg4NTktMSI/Pgo8RGViaXROb3RlIHhtbG5zPSJ1cm46b2FzaXM6bmFtZXM6c3BlYg==",
        "ticket": "2ff80752-e6c4-48cc-aae1-475a9312acbb"
    }
}

Respuesta Cdr

{
    "success": true,
    "data": {
        "filename": "20607006521-09-TG01-00000001",
        "code": "0",
        "description": "El Comprobante numero TG01-00000001, ha sido aceptado",
        "link_QrCode": "https://e-factura.sunat.gob.pe/v1/contribuyente/gr..."
    }
}

Guía de Remisión Transportista

{
    "documento": {
        "tipo_guia": "31",
        "serie": "VG01",
        "numero": "00000001",
        "fecha_emision": "2025-03-21",
        "hora_emision": "10:43:48",
        "nota": null
    },
    "emisor": {
        "tipo": 6,
        "numero": "20187001839",
        "razon_social": "REPRESENTACIONES PEPITO E.I.R.L.",
        "direccion": "CAL.JUAN CUGLIEVAN NRO. 1379 INT. A CERCADO DE CHICLAYO LAMBAYEQUE - CHICLAYO - CHICLAYO"
    },
    "cliente": {
        "tipo": "6",
        "numero": "20109065611",
        "razon_social": "CONSTRUCCION Y ADMINISTRACION DEL NORTE PERU S.A."
    },
    "documento_referencia": [],
    "tercero": [],
    "envio": {
        "peso_bruto": "35.00",
        "unidad_medida": "KGM",
        "indicadores": [
            {
                "valor": "1"
            },
            {
                "valor": "11"
            }
        ],
        "fecha_traslado": "2025-03-17",
        "transportista": {
            "tipo_documento": "6",
            "numero": "20000000000",
            "razon_social": "EMPRESA EMISORA DE PRUEBA S.A.C.",
            "numero_mtc": "0001"
        },
        "conductores": [
            {
                "tipo_documento": "1",
                "numero": "16700281",
                "nombres": "MANUEL",
                "apellidos": "VILLANUEVA MERA",
                "tipo": "Principal",
                "licencia": "C16333281"
            },
            {
                "tipo_documento": "1",
                "numero": "13705289",
                "nombres": "JOSE",
                "apellidos": "VERGARA MEJIA",
                "tipo": "Secundario",
                "licencia": "C13705289"
            }
        ],
        "llegada": {
            "ubigeo": "130702",
            "ruc": "20109565017",
            "direccion": "AV. NILA CERRUTI NRO. 290"
        },
        "partida": {
            "ubigeo": "140101",
            "ruc": "20487911829",
            "direccion": "CAL.JUAN CUGLIEVAN NRO. 1379 INT. A CERCADO DE CHICLAYO LAMBAYEQUE - CHICLAYO - CHICLAYO"
        },
        "vehiculo": {
            "placa": "C4C2928",
            "tarjeta_circulacion": "15P170014000001",
            "secundarios": [
                {
                    "placa": "C4C2928",
                    "tarjeta_circulacion": "15P170014000001",
                }
            ]
        }
    },
    "items": [
        {
            "id": 1,
            "codigo": "PRO00930",
            "descripcion": "ENVASE DELI 1 LT TR PET SUPER FAST CAJA",
            "unidad": "MIL",
            "cantidad": 3.5
        },
        {
            "id": 2,
            "codigo": "PRO02046",
            "descripcion": "TAPA DELI 1 LT D2 SUPER FAST TR PP",
            "unidad": "MIL",
            "cantidad": 3.5
        }
    ]
}

Respuesta Ticket

{
    "success": true,
    "data": {
        "filename": "20607006521-09-TG01-00000001",
        "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iaXNvLTg4NTktMSI/Pgo8RGViaXROb3RlIHhtbG5zPSJ1cm46b2FzaXM6bmFtZXM6c3BlYg==",
        "ticket": "2ff80752-e6c4-48cc-aae1-475a9312acbb"
    }
}

Respuesta Cdr

{
    "success": true,
    "data": {
        "filename": "20607006521-09-TG01-00000001",
        "code": "0",
        "description": "El Comprobante numero TG01-00000001, ha sido aceptado",
        "link_QrCode": "https://e-factura.sunat.gob.pe/v1/contribuyente/gr..."
    }
}