XML y XSD – Factura Comercial de Exportación YPFB


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

mesFacturacion

Alfanumérico

Si

Máximo de 100 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”

direccionDestinatario

Alfanumérico

Si

Máximo de 300 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”

incoterm

Alfanumérico

Si

Máximo de 100 caracteres

codigoCliente

Alfanumérico

Si

Máximo de 100 caracteres, deberá ser asignado por el sistema de facturación del contribuyente

lugarDestino

Alfanumérico

Si

Máximo de 100 caracteres

codigoPais

Numérico

Si

Puede tener valores del 1 al 9999

montoTotal

Numérico

Si

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

precioValorBruto

Numérico

Si

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

gastosTransporteFrontera

Numérico

Si

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

gastosSeguroFrontera

Numérico

Si

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

totalFobFrontera

Numérico

Si

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

montoTransporteFrontera

Numérico

Si

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

montoSeguroInternacional

Numérico

Si

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

otrosMontos

Numérico

No

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

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.

montoTotalCPT

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 comercial de exportación YPFB deberá ser 24.

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

partidaArancelaria

Alfanumérico

Si

Máximo de hasta 50 caracteres

descripcion

Alfanumérico

Si

Máximo de hasta 200 caracteres

cantidad

Numérico

Si

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

unidadMedida

Numérico

Si

Máximo de hasta 4 caracteres

energiaMMBTU

Numérico

Si

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

precioSusMMBTU

Numérico

No

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

subTotal

Numérico

Si

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 Exportación YPFB (Descargar)

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

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

  <cabecera>

    <nitEmisor>1020269020</nitEmisor>

    <numeroFactura>8</numeroFactura>

    <cuf>1eecd7b50eef5e5bde755ca05f735</cuf>

    <cufd>1eecd7b50eef5e5bde755ca05f735</cufd>

<codigoSucursal>104</codigoSucursal>

    <direccion>Av Doble Via a la Guardia S/N</direccion>

    <mesFacturacion>Diciembre/2018</mesFacturacion>

    <codigoPuntoVenta xsi:nil="true"></codigoPuntoVenta>

    <fechaEmision>2019-01-15T15:11:36.169</fechaEmision>

    <destinatario>Mr. Joseph Martins</destinatario>

    <direccionDestinatario>Suite 210 - 200 Burrard Street</direccionDestinatario>

    <codigoMetodoPago>1</codigoMetodoPago>

    <numeroTarjeta xsi:nil="true"></numeroTarjeta>

    <codigoTipoDocumentoIdentidad>5</codigoTipoDocumentoIdentidad>

    <numeroDocumento>99005</numeroDocumento>

    <complemento xsi:nil="true"></complemento>

<incoterm>CPT-VANCOUVER</incoterm>

    <codigoCliente>12354</codigoCliente>

    <lugarDestino>VANCOUVER-CANADA</lugarDestino>

    <codigoPais>391</codigoPais>

    <montoTotal>69600.00</montoTotal>

    <precioValorBruto>6975</precioValorBruto>

    <gastosTransporteFrontera>375</gastosTransporteFrontera>

    <gastosSeguroFrontera>150</gastosSeguroFrontera>

    <totalFobFrontera>7500</totalFobFrontera>

    <montoTransporteFrontera>2000</montoTransporteFrontera>

    <montoSeguroInternacional>500</montoSeguroInternacional>

    <otrosMontos xsi:nil="true"></otrosMontos>

    <codigoMoneda>689</codigoMoneda>

    <tipoCambio>6.96</tipoCambio>

    <montoTotalMoneda>32075.71</montoTotalMoneda>

    <montoTotalCPT>10000</montoTotalCPT>

    <leyenda>Ley N° 453: Los servicios deben suministrarse en condiciones de inocuidad, calidad y seguridad</leyenda>

    <usuario>SA21</usuario>

    <codigoDocumentoSector>24</codigoDocumentoSector>

  </cabecera>

  <detalle>

    <actividadEconomica>12</actividadEconomica>

    <codigoProductoSin>222222</codigoProductoSin>

    <codigoProducto>12345</codigoProducto>

    <partidaArancelaria>2711.21.00.00</partidaArancelaria>

    <descripcion>GAS NATURAL: Estado Gaseoso</descripcion>

    <cantidad>272734024</cantidad>

    <unidadMedida>1</unidadMedida>

    <energiaMMBTU>10035984.9</energiaMMBTU>

    <precioSusMMBTU>100.00</precioSusMMBTU>

    <subTotal>10000</subTotal>

  </detalle>

</facturaComputarizadaComercialExportacionYPFB>

 


Archivo XSD para Factura Exportación YPFB (Descargar)

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

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

  <xs:element name="facturaComputarizadaComercialExportacionYPFB">

    <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="99999999" />

                  </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="mesFacturacion" >

                <xs:simpleType>

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

                    <xs:minLength value="1" />

                    <xs:maxLength value="100" />

                  </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="destinatario" >

                <xs:simpleType>

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

                    <xs:minLength value="1" />

                    <xs:maxLength value="200" />

                  </xs:restriction>

                </xs:simpleType>

              </xs:element>     

            <xs:element name="direccionDestinatario">

                <xs:simpleType>

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

                    <xs:minLength value="1" />

                    <xs:maxLength value="300" />

                  </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="numeroTarjeta" nillable="true">

                <xs:simpleType>

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

                    <xs:maxInclusive value="9999999999999999" />

                    <xs:minExclusive value="0" />

                  </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="incoterm">

                <xs:simpleType>

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

                    <xs:minLength value="1" />

                    <xs:maxLength value="100" />

                  </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="lugarDestino" >

                <xs:simpleType>

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

                    <xs:minLength value="1" />

                    <xs:maxLength value="100" />

                  </xs:restriction>

                </xs:simpleType>

              </xs:element>

              <xs:element name="codigoPais">

                <xs:simpleType>

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

                    <xs:maxInclusive value="9999" />

                        <xs:minExclusive value="0" />

                  </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="precioValorBruto">

                <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="gastosTransporteFrontera">

                <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="gastosSeguroFrontera">

                <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="totalFobFrontera">

                <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="montoTransporteFrontera">

                <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="montoSeguroInternacional">

                <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="otrosMontos" 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="codigoMoneda">

                <xs:simpleType>

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

                    <xs:maxInclusive value="9999" />

                        <xs:minExclusive value="0" />

                  </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="montoTotalCPT">

                <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="24" />

         </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="partidaArancelaria">

                <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="energiaMMBTU">

                <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="precioSusMMBTU" 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:sequence>

          </xs:complexType>

        </xs:element>

      </xs:sequence>

    </xs:complexType>

  </xs:element>

</xs:schema>