ESPECIFICACIONES FACTURACION ELECTRONICA GAS

STATION

Gasolutions SAS
Versión 1.9

Versión Fecha Control Cambios

1.0 09/09/2016

1.1 08/09/2017 Se elimina precio de la clase ítem.

1.2 19/12/2017 Se agrega la clase venta.

1.3 28/02/2018 Tipo Operación Exonerada y

Descuentos, Campo Placa.

1.4 08/03/2018 Se toman medidas para facturar

varias ventas.

1.5 14/03/2018 Se agregan operación al ítem.

1.6 21/03/2018 Se agrega clase Recaudo.

1.7 29/05/2018 Se agrega porcentaje al tributo.

1.8 03/04/2018 Se agregan formas de pago,

donación y redondeo.

1.9 16/09/2019 Agregar la franquicia a la forma de

pago y porcentaje de descuento en
el Item.

Gasolutions S.A.S.
GENERALIDADES:

El servicio que se expone a continuación, permitirá la generación de facturación electrónica

enlazada con el Sistema Gas Station.

Los tag Url son sugerencias realizadas pero de acuerdo a su experiencia eligen el campo que
debe ser ante la SUNAT

DICCIONARIO DE DATOS:

Tipo Documento: identifica el tipo de documento a ser emitido.

Tipo Documento
Tipo Documento Valor Tipo Valor
Boleta 3 Entero
Factura 1 Entero
NotaCredito 7 Entero
NotaDebito 8 Entero

Tipo Operación: referencia el tipo de operación tributaria a realizar

Tipo Operación
Tipo Operación Valor Tipo Valor
OperacionGravada 1 Entero
OperacionInafecta 2 Entero
OperacionExonerada 3 Entero
OperacionGratuita 4 Entero
Descuento 5 Entero

Nota: GasStation tiene las siguientes operaciones OperacionGravada que corresponde a la

operación 10 del catálogo de afectación al IGV y OPeracionGratuita que corresponde a la
operación 21 del catálogo de afectación al IGV. El abono crédito se enviará dentro de la clase
recaudo y el descuento por cada ítem

Gasolutions S.A.S.
Tipo Tributo: definición del tipo de impuesto a generar.
Tipo Tributo
Tipo Tributo Valor Tipo Valor
IGV 1 Entero
ISC 2 Entero
Otros 3 Entero

Tipo Leyenda: Identifica la leyenda a generar.

Tipo Leyenda
Tipo Leyenda Valor Tipo Valor
MontoLetras 1000 Entero
Transferencia 1002 Entero

DICCIONARIO DE MÉTODOS WEB

Nombre del Método Web Descripción

No
1 GenerarDocumento Entrega información para la generación de la
factura electrónica con la información de la
venta.

ESPECIFICACIONES METODOS WEB:

1. GenerarDocumento
No Parámetros entrada Respuesta
1 Objet Documento Objet RespuestaFacturacion

Gasolutions S.A.S.
DICCIONARIO DE CLASES

No Nombre de la Clase Descripción

1 Item Define los datos básicos referentes a la venta a facturar
2 Leyenda Retorna la leyenda a incluir en la factura
3 Operación Retorna tipo operación a realizar
4 Tributo Retorna tipo tributo a realizar
5 Documento Retorna los datos básicos del documento
6 Venta Retorna los datos básicos de la venta
7 Recaudo Retorna la información de recaudo a terceros
8 RespuestaFacturacion Se registra la respuesta del sistema de facturación.
9 MedioPago Retorna la información de los medios de pago con los
cuales fue pagada la venta

Gasolutions S.A.S.
ESPECIFICACIONES CLASES:

1. CLASE ITEM
Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 codigoProducto Numero Min. 1 Valor positivo, Identificador único /Invoice/cac:InvoiceLine/cac:Item/cac:SellersItemI
positivo Max. 2 por defecto del producto dentification/cbc:ID
Dígitos será enviado contenido en la
código 1, o el venta
código SUNAT
del producto
GNV.
2 valor Número Min. 1 Valor positivo Valor de la venta SIN /Invoice/cac:InvoiceLine/cbc:LineExtensionAmount
decimal Max. 13 IGV, valor unitario * /@currencyID
Dígitos cantidadItem
3 precioUnitario Número Min. 1 Valor positivo Precio del Gas con
decimal Max. 13 IGV
Dígitos
4 valorUnitario Número Min. 1 Valor positivo Precio del Gas sin
decimal Max. 13 IGV
Dígitos
5 unidadItem Cadena 3 MTQ sera enviado /Invoice/cac:InvoiceLine/cbc:InvoicedQuantity/@unitCo
Caracteres segun for Units of de (Unidad de medida - Catálogo No. 03)
MeasureUsed in
International Trade
6 cantidadItem Número 22 dígitos 12 dígitos Volumen en m3 de la /Invoice/cac:InvoiceLine/cbc:InvoicedQuantity
decimal enteros, cantidad de Gas
10 Vendido
decimales
7 descripcionItem Cadena Max. 250 Por defecto GAS Por defecto GAS /Invoice/cac:InvoiceLine/cac:Item/cbc:Description
caracteres NATURAL NATURAL
VEHICULAR VEHICULAR

Gasolutions S.A.S.
 8 igvItem Número Min. 1 Valor positivo Valor del tributo
Decimal Max. 13
Dígitos
9 importe Número Min. 1 Valor positivo Valor de la venta
Decimal Max. 13 CON IGV, precio
Dígitos unitario *
cantidadItem -
Descuento
10 descuentoItem Número Min. 1 Valor positivo Descuento que se le
Decimal Max. 13 dan al cliente
Dígitos
11 Placa Cadena 18 Corresponde a la
caracteres placa del vehículo

12 numeroItem Numero Entero en Valor positivo Corresponde a un

Entero base 64 número correlativo
para identificar la
venta
13 tipoOperacion Numero 1 dígito Valor entre 1 y 5 Identificador único
positivo del tipo de Operación

14 monto Número Min. 1 Valor positivo Monto de la

Decimal Max. 13 operación
Dígitos
15 subtotal Número Min. 1 Valor Positivo Importe – IGV del
Decimal Max. 13 ítem
Dígitos
16 porcentajeDescuento Número Min. 1 Valor Positivo Porcentaje del
Decimal Max. 13 descuento aplicado
Dígitos

Gasolutions S.A.S.
 2. CLASE LEYENDA
Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 tipoLeyenda Numero 4 dígitos Valor entre Identificador único /Invoice/ext:UBLExtensions/ext:UBLExtension/ext:Exte
positivo 1000 y 1002 del tipo de leyenda nsionContent/sac:AdditionalInformation/sac:Additiona
lProperty/cbc:ID (Código de la leyenda - Catálogo No.
15)
2 descripcion Cadena Descripción del tipo /Invoice/ext:UBLExtensions/ext:UBLExtension/ext:Exte
de leyenda nsionContent/sac:AdditionalInformation/sac:Additiona
lProperty/cbc:Value (Descripción de la leyenda)

3. CLASE OPERACION
Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 tipoOperacion Numero 1 dígito Valor entre 1 y 5 Identificador único /Invoice/ext:UBLExtensions/ext:UBLExtension/ext:Exte
positivo del tipo de nsionContent/sac:AdditionalInformation/sac:Additiona
Operación lMonetaryTotal/cbc:ID (Código de tipo de monto -
Catálogo No. 14)
2 monto Número Min. 1 Valor positivo Monto de la /Invoice/ext:UBLExtensions/ext:UBLExtension/ext:Exte
decimal Max. 13 operación nsionContent/sac:AdditionalInformation/sac:Additiona
Dígitos lMonetaryTotal/cbc:PayableAmount (Monto)

4. CLASE TRIBUTO
Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 tipoTributo Numero 1 dígito Valor positivo Identificador único /Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory
positivo entre 1 y 3 del tipo de tributo /cac:TaxScheme/cbc:ID (Código de tributo - Catálogo
No. 05)

Gasolutions S.A.S.
 2 valor Número Min. 1 Valor positivo Valor del tributo /Invoice/cac:InvoiceLine/cac:TaxTotal/cbc:TaxAmount/
decimal Max. 13 @currencyID (Monto de IGV de la línea)
Dígitos
3 porcentajeTributo Numero Min 1 Valor Positivo Porcentaje aplicado
Decimal Max 2 al tributo

5.CLASE DOCUMENTO

Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 tipoDocumento Numero 1 dígito Valor positivo 2 Se han definido los 4 /Invoice/cbc:InvoiceTypeCode (Tipo de documento -
positivo dígitos documentos Boleta, Catálogo No. 01)
Factura, Nota Debito y
Nota crédito
2 fechaEmision Fecha 10 Formato 24 Fecha de la emisión del /Invoice/cbc:IssueDate
Caracteres horas yyyy- documento
MMdd
3 rucEmisor cadena 11 Longitud y Ruc del emisor, los /Invoice/cac:AccountingSupplierParty/cbc:CustomerAss
Caracteres formato de RUC demás datos serán ignedAccountID (Número de RUC)
propios del sistema de
facturación como:
Nombre comercial,
Razón Social o
Apellidos Nombre,
Domicilio Fiscal

Gasolutions S.A.S.
 4 numeracion Cadena 13 Formato F###- Serie y numero /Invoice/cbc:ID
Caracteres NNNNNNNN correlativo será
El primer generado por el
carácter sistema GasStation
corresponde
al tipo de
documento
5 tipoDocumento Numero 1 dígito según catalogo Tipo del documento /Invoice/cac:AccountingCustomerParty/cbc:AdditionalA
Adquiriente positivo N°6 de la SUNAT del cliente ccountID (Tipo de documento - Catálogo No 6)
(adquirente) que
adquiere el Gas será
enviado según
catalogo N°6 de la
SUNAT
6 numeroDocume Cadena Hasta 15 Formato RUC o Número del /Invoice/cac:AccountingCustomerParty/cbc:CustomerA
ntoAdquiriente Caracteres DNI documento del ssignedAccountID (Número de documento)
cliente (adquirente)
que adquiere el Gas
7 nombreAdquirie Cadena Max 100 Nombre y Apellidos /Invoice/cac:AccountingCustomerParty/cac:Party/cac:P
nte Caracteres del cliente artyLegalEntity/cbc:RegistrationName
(adquirente) que
adquiere el Gas
8 direccionAdquiri Cadena Max 100 Dirección del cliente /Invoice/cac:AccountingCustomerParty/cac:Party/cac:P
ente Caracteres (adquirente) que hysicalLocation/cbc:Description
adquiere el Gas
9 operacion Lista<O Validar Operaciones gravadas,
bject> especificaciones infectas y exoneradas.
Clase
Operaci Clase
ón Operación.

Gasolutions S.A.S.
 10 tributos Lista<O Validar GasStation
bject> especificaciones corresponde el IGV
Clase Clase y/o descuentos
Tributo Operación.
11 otrosCargos Número Se enviará en Corresponde al valor /Invoice/cac:LegalMonetaryTotal/cbc:ChargeTotalAmou
decimal cero por de otros cargos. nt/@currencyID
defecto
12 totalVenta Número 14 dígitos 12 Enteros, 2 Total de la venta /Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount/
decimal decimales @currencyID
13 tipoMoneda Cadena 3 Siempre será Tipo Moneda /Invoice/cbc:DocumentCurrencyCode (Código de
caracteres PEN: Nuevo Sol moneda - Catálogo No. 02)

14 item Lista<O Validar Corresponde a la

bject> especificaciones información del GNV
Clase Clase Item.
Item
15 leyenda Lista<O Validar Corresponde a la
bject> especificaciones leyenda del monto
Clase Clase Leyenda. en letras y/o
Leyenda transferencia
gratuita
16 codigoNotaCred Cadena 13 Opcional – Solo /CreditNote/cac:DiscrepancyResponse/cbc:ResponseCo
itoDebito Caracteres aplica para nota de (Código de tipo de nota de crédito - Catálogo No. 09)
credito /DebitNote/cac:DiscrepancyResponse/cbc:ResponseCo
de (Código de tipo de nota de débito - Catálogo No. 10)
17 documentoAfec Cadena 13 Opcional – Solo /DebitNote/cac:DiscrepancyResponse/cbc:ReferenceID
tado Caracteres aplica para nota (Serie y número de documento afectado)
credito
18 tipoDocumento Cadena 2 Opcional – Solo /DebitNote/cac:BillingReference/cac:InvoiceDocumentR
Afectado Caracteres aplica para nota eference/cbc:DocumentTypeCode
crédito

Gasolutions S.A.S.
 19 motivoSustento Cadena 250 Opcional – Solo /DebitNote/cac:DiscrepancyResponse/cbc:Description
Caracteres aplica para nota
crédito
20 venta Lista< Validar Corresponde a
Object> especificaciones datos de la venta
Clase Clase Venta. que puede usar
Venta en los formatos
de facturación
personalizados
21 recaudos Lista< Validar Corresponde a
Object> especificaciones datos del
Clase Clase Recaudo. Recaudo a las
Recaudos financieras
realizado

6. CLASE VENTA

Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 Maquina Cadena 50 Serial de la
Registradora caracteres impresora donde se
realiza la impresión
del documento fiscal
2 Hora Fecha 8 Formato 24 Hora de emisión del
caracteres horas HH:mm:ss documento

3 Turno Numero 1 digito Numero positivo El número de turno

de la estación de
servicio
4 Cara Numero 2 dígitos Numero Cara donde se
positivo realizó la venta

Gasolutions S.A.S.
 5 Isla Numero 2 dígitos Numero positivo Isla donde se realizó
la venta
6 Manguera Numero 2 dígitos Numero positivo Manguera donde se
realizó la venta

7 Recibo Numero Entero en Numero positivo Es el identificador

base 64 en base 64 único de la venta

8 FechaHora Cadena 12 ddmmyyyyHHmm Fecha y Hora de la

caracteres venta

9 FechaProximo Cadena 10 dd/mm/yyyy Fecha de próximo

Mantenimiento caracteres mantenimiento del
vehículo
10 FechaRevision Cadena 10 dd/mm/yyyy Fecha de revisión
Cilindro caracteres del cilindro

11 Redondeo Número Min. 1 Monto del

decimal Max. 13 redondeo de la
Dígitos operación
12 Donacion Número Min. 1 Monto de la
decimal Max. 13 donación realizada
Dígitos
13 MedioPago Lista< Validar Corresponde a
Object> especificaciones datos de la
Clase Clase MedioPago. forma de pago
MedioPago de la venta

Gasolutions S.A.S.
7. CLASE RECAUDO

Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 financiera Cadena 100 Financiera a la cual
caracteres se le realizo el
recaudo

2 porcentaje Número Min. 1 Numero de 1 a Porcentaje definido

decimal Max. 3 100 para realizar el
Dígitos recaudo
3 monto Número Min. 1 Monto del recaudo
decimal Max. 13 realizado
Dígitos

8. CLASE RESPUESTA FACTURACION

Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 MensajeError Cadena 250 Valor por En caso de error se
Caracteres defecto enviará la descripción
Vacío. de la falla, de lo
contrario será vacío
2 SolicitudProcesada Booleano 1 digito True cuando todo
este correcto, False
si existe una falla
3 ValorResumen Cadena 3000 Valor resultado de
Caracteres aplicar la función
hash al xml
4 ValorFirma Cadena 3000 Valor de la firma en
Caracteres base 64

Gasolutions S.A.S.
9. CLASE MEDIO DE PAGO

Parámetros
No Atributo Tipo Tamaño Validación Descripción TAG UBL
1 IdFormaPago Numero 2 dígitos Numero Id de la forma de
positivo pago
2 FormaPago Cadena 20 Indica la forma de
caracteres pago con la cual fue
realizada la venta
3 Monto Numero Min. 1 Monto de la forma
Max. 13 de pago
Dígitos
4 Franquicia Cadena 20 Tipo de tarjeta
caracteres (Visa, Amex,
Mastercad)

Gasolutions S.A.S.