XML y XSD – Factura de Hidrocarburos


Nombre Campo

Tipo Dato

Obligatorio

Consideraciones

CABECERA

nitEmisor

Numérico

Si

Máximo de 13 caracteres

numeroFactura

Numérico

Si

Máximo de 8 caracteres

cuf

Alfanumérico

Si

Máximo de 100 caracteres

cufd

Alfanumérico

Si

Máximo de 100 caracteres

codigoSucursal

Numérico

Si

Máximo hasta la 9999, también puede ser 0 (casa matriz)

direccion

Alfanumérico

Si

Máximo de 300 caracteres

codigoPuntoVenta

Numérico

No

Si no existe debería enviar en el Etiqueta xsi:nil=”true” en el campo caso contrario debera ser mayor a 0 y menor a 9999

fechaEmision

Fecha

Si

Deberá estar en formato UTC Extendido, por ejemplo: “2019-02-13T08:32:12.125”

nombreRazonSocial

Alfanumérico

Si

Máximo de 200 caracteres

codigoTipoDocumentoIdentidad

Numérico

Si

Puede tener valores del 1 al 9

numeroDocumento

Alfanumérico

Si

Máximo de 20 caracteres

complemento

Alfanumérico

No

Solo se podrá enviar cuando el tipoDocumentoIdentidad es igual 1, pero puede ser nulo agregando en el Etiqueta xsi:nil=”true”

ciudad

Alfanumérico

 

Máximo de 100 caracteres

nombrePropietario

Alfanumérico

 

Máximo de 100 caracteres

nombreRepresentanteLegal

Alfanumérico

 

Máximo de 100 caracteres

condicionPago

Alfanumérico

 

Máximo de 150 caracteres

periodoEntrega

Alfanumérico

 

Máximo de 150 caracteres

codigoMetodoPago

Numérico

Si

Puede tener valores de 1 a 99

montoTotal

Numérico

Si

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0

montoDescuento

Numérico

No

Puede ser decimal con 20 dígitos en la parte entera y con hasta 5 decimales, si no existe deberá ser nulo.

montoIehd

Numérico

Si

Impuesto especial a los hidrocarburos y derivados.

Puede ser decimal con 20 dígitos en la parte entera y con hasta 5 decimales.

codigoMoneda

Numérico

Si

Puede tener valores del 688 al 2080

tipoCambio

Numérico

Si

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0, si el código de moneda es Bolivianos (688) deberá ser igual a 1.

montoTotalMoneda

Numérico

Si

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0, si el código de moneda es Bolivianos (688) deberá ser igual al monto total.

leyenda

Alfanumérico

Si

Deberá ser una de las leyendas asociadas a la actividad enviadas al momento de la sincronización, Máximo será de 200 caracteres.

usuario

Alfanumérico

Si

Podrá ser de hasta 100 caracteres, deberá ser descriptivo, por ejemplo: JPEREZ

codigoDocumentoSector

Numérico

Si

Para la factura de hidrocarburos deberá ser 23.

DETALLE

actividadEconomica

Numérico

Si

Máximo de hasta 8 caracteres.

codigoProductoSin

Numérico

Si

Máximo de hasta 8 caracteres

codigoProducto

Alfanumérico

Si

Máximo de hasta 50 caracteres

descripción

Alfanumérico

Si

Máximo de hasta 200 caracteres

cantidad

Numérico

No

Máximo de hasta 4 caracteres

unidadMedida

Numérico

Si

Máximo de hasta 4 caracteres

precioUnitario

Numérico

Si

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0

montoDescuento

Numérico

No

Puede ser decimal con 20 dígitos en la parte entera y con hasta 5 decimales, si no existe deberá ser nulo.

subTotal

Numérico

Si

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0

porcentajeIehd

Numérico

No

Decimal con hasta 20 dígitos en la parte entera y con hasta 5 decimales, deberá ser mayor a 0

 


 

Notas

Los archivos XML generados deben estar en formato UTF-8, no en “UTF-8 BOM”, esta configuración debe realizarse antes de la generación del XML, por ejemplo, se tiene el siguiente código en lenguaje C#

xmlDocument doc = new xmlDocument();
XmlNode docNode = doc.CreateXMLDeclaration("1.0", "UTF-8", null);
doc.Appendchild(docNode);

Para la modalidad de Facturación Electrónica en línea cada factura debe ser firmada digitalmente, se puede ver un ejemplo de código de implementación del firmado en JAVA en el apartado Firmado de documentos XML

Las paramétricas a utilizarse en los códigos utilizados en la construcción del XML (Ejemplo codigoTipoDocumentoIdentidad), pueden ser encontrados en los catálogos para facturación electrónica.

 


 

Archivo XML de la Factura de Hidrocarburo (Descargar)

<?xml version="1.0" encoding="utf-8"?>

<facturaComputarizadaHidrocarburo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="facturaComputarizadaHidrocarburo.xsd">

<cabecera>

<nitEmisor>102083461021</nitEmisor>

<numeroFactura>9863</numeroFactura>

<cuf>a812312f1223892b</cuf>

<cufd>1eecd7b50eef5e5bde755ca05f735</cufd>

<codigoSucursal>0</codigoSucursal>

<direccion>Calle Juan Pablo II #786</direccion>

<codigoPuntoVenta xsi:nil="true" />

<fechaEmision>2019-04-05T12:12:12.125</fechaEmision>

<nombreRazonSocial>Petrobras Company</nombreRazonSocial>

<codigoTipoDocumentoIdentidad>5</codigoTipoDocumentoIdentidad>

<numeroDocumento>20461023</numeroDocumento>

<complemento xsi:nil="true" />

<codigoCliente>pebra</codigoCliente>

<ciudad>Tarija</ciudad>

<nombrePropietario>Fernando Arevalo</nombrePropietario>

<nombreRepresentanteLegal>Juan Perez</nombreRepresentanteLegal>

<condicionPago>pago post contrato</condicionPago>

<periodoEntrega>Agosto 2019</periodoEntrega>

<codigoMetodoPago>3</codigoMetodoPago>

<montoTotal>5004500000</montoTotal>

<montoDescuento xsi:nil="true" />

<montoIehd>50464</montoIehd>

<codigoMoneda>689</codigoMoneda>

<tipoCambio>6.89</tipoCambio>

<montoTotalMoneda>72634252.53991</montoTotalMoneda>

<leyenda>Ley N° 453: El proveedor debe brindar atención sin discriminación, con respeto, calidez y cordialidad a los usuarios y consumidores.</leyenda>

<usuario>SistYPFB</usuario>

<codigoDocumentoSector>23</codigoDocumentoSector>

</cabecera>

<detalle>

<actividadEconomica>493000</actividadEconomica>

<codigoProductoSin>65131</codigoProductoSin>

<codigoProducto>GNV-LP</codigoProducto>

<descripcion>Gas Natural</descripcion>

<cantidad>1</cantidad>

<unidadMedida>1</unidadMedida>

<precioUnitario>5004500000</precioUnitario>

<montoDescuento xsi:nil="true" />

<subTotal>5004500000</subTotal>

<porcentajeIehd>6.96</porcentajeIehd>

</detalle>

</facturaComputarizadaHidrocarburo>

 

Archivo XSD para Factura de Hidrocarburo (Descargar)

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" attributeFormDefault="unqualified" elementFormDefault="qualified">

<xs:element name="facturaComputarizadaHidrocarburo">

<xs:complexType>

<xs:sequence>

<xs:element name="cabecera">

<xs:complexType>

<xs:sequence>

<xs:element name="nitEmisor">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="9999999999999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="numeroFactura">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="9999999999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="cuf">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="cufd">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoSucursal">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="0" />

<xs:maxInclusive value="9999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="direccion">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="300" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoPuntoVenta" nillable="true">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minExclusive value="0" />

<xs:maxInclusive value="9999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="fechaEmision" type="xs:dateTime" />

<xs:element name="nombreRazonSocial">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="200" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoTipoDocumentoIdentidad">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="9" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="numeroDocumento">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="20" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="complemento" nillable="true">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:maxLength value="5" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoCliente">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="ciudad">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="0" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="nombrePropietario">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="nombreRepresentanteLegal">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="condicionPago">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="150" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="periodoEntrega">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="150" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoMetodoPago">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="99" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="montoTotal">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="montoDescuento" nillable="true">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="montoIehd">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoMoneda">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minExclusive value="0" />

<xs:maxInclusive value="9999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="tipoCambio">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="montoTotalMoneda">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="leyenda">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="200" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="usuario">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="100" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoDocumentoSector" type="xs:integer" fixed="23" />

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="detalle" minOccurs="1" maxOccurs="unbounded">

<xs:complexType>

<xs:sequence>

<xs:element name="actividadEconomica">

<xs:simpleType>

<xs:restriction base="xs:long">

<xs:minInclusive value="1" />

<xs:maxInclusive value="99999999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoProductoSin">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="99999999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="codigoProducto">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="50" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="descripcion">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:minLength value="1" />

<xs:maxLength value="200" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="cantidad">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="unidadMedida">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="1" />

<xs:maxInclusive value="9999" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="precioUnitario">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="montoDescuento" nillable="true">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="subTotal">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="porcentajeIehd" nillable="true">

<xs:simpleType>

<xs:restriction base="xs:decimal">

<xs:totalDigits value="20" />

<xs:fractionDigits value="5" />

<xs:minExclusive value="0" />

</xs:restriction>

</xs:simpleType>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:schema>