En este artículo se describe el efecto funcional del software en varios campos de las facturas de venta XML. Este XML debe ser presentado con el método de servicio web Sales - ProcessSalesInvoices(sessionID, administrationId, xmlDoc).  

PRESTA ATENCIÓN

Se recomienda pasar por el esquema XML. Esta información puede ser muy útil y está descrita en inglés. 

Dirección web del esquema XML de las facturas de venta 

http://www.yukiworks.es/schemas/SalesInvoices.xsd

Ejemplo de esquema XML

<SalesInvoices xmlns="urn:xmlns:http://www.theyukicompany.com:salesinvoices" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SalesInvoice>
<Reference>XX-1234</Reference>
<Subject>Testfactuur - 1</Subject>
<PaymentMethod>ElectronicTransfer</PaymentMethod>
<PaymentID>1234-456</PaymentID>
<Process>true</Process>
<EmailToCustomer>false</EmailToCustomer>
<Layout />
<Date>2012-06-22</Date>
<DueDate>2012-07-22</DueDate>
<PriceList />
<Currency />
<ProjectID />
<ProjectCode />
<Remarks />
                <Contact>

                        <ContactCode>1122</ContactCode>
<FullName>Apple Sales International</FullName>
<FirstName />
<MiddleName />
<LastName />
<Gender>Male</Gender>
<CountryCode>NL</CountryCode>
<City>Rotterdam</City>
<Zipcode>1234 AA</Zipcode>
<AddressLine_1>Bergweg 25</AddressLine_1>
<AddressLine_2 />
<Website />
<CoCNumber />
<VATNumber />
<ContactType>Company</ContactType>
<BankAccount />
<PhoneHome />
                        <MobileHome />

                </Contact>
                <ContactPerson>

                        <FirstName>Steve</FirstName>
<LastName>Jobs</LastName>
                        <Gender>Male</Gender>

                        <EmailAddress>steve@apple.com</EmailAddress>
</ContactPerson>
                <InvoiceLines>

                        <InvoiceLine>
<Description>Regel 1</Description>
<Remarks />
<ProductQuantity>2</ProductQuantity>
<Product>
<Description>Product 1</Description>
<Reference>TP-1122</Reference>
<Category xsi:nil="true" />
<SalesPrice>14.88</SalesPrice>
<VATPercentage>6.00</VATPercentage>
<VATIncluded>true</VATIncluded>
<VATType>2</VATType>
<GLAccountCode></GLAccountCode>
<Remarks />
</Product>
</InvoiceLine>
</InvoiceLines>
</SalesInvoice>
</SalesInvoices>

Campos de descripción 

A continuación puede encontrar una descripción de los campos. El esquema XML también incluye una descripción de los campos, así como los valores y tipos de datos que se esperan. 

SalesInvoice: Reference 

En este campo se puede registrar el número de la factura. 

La factura ha sido creada, impresa y/o enviada externamente. Por consiguiente, el número de factura se ha facilitado externamente.

El campo "Reference" incluye el número de la factura y el campo "Process" tiene que tener el valor "True" para que Yuki sepa que la factura y sus detalles correspondientes pueden ser procesados.

La factura debe ser procesada, impresa y/o enviada manualmente por Yuki. Por lo tanto, el número de la factura será proporcionado por Yuki.

El campo "Reference" debe dejarse en blanco y el campo "Process" debe tener el valor "False".

SalesInvoice: PaymentMethod 

En este campo se puede registrar la forma de pago de la factura. Opciones posibles: 

• Unspecified (el método de pago por defecto que cogerá Yuki será "Transferencia bancaria")
• ElectronicTransfer (Transferencia bancaria)
• DirectCollection (el método de pago Domiciliación deberá ser previamente activado en el dominio)
• CreditCard
• DebitCard 
• Cash
• iDeal
• Online.

SalesInvoice: Process 

En este campo se indica si se desea que las facturas se procesen automáticamente. Para procesar la factura, debes introducir el número de factura correcto en el campo "Reference". Si el valor es 'True', la factura será procesada sin el consentimiento de Yuki y enviada al cliente (si se indica). Si el valor es "False", la factura será dirigida a la lista "Listo para ser enviado" y la factura tiene que ser aprobada antes de que pueda ser procesada.

Si el proceso del TAG falta, Yuki asumirá el valor "False". 

SalesInvoice: EmailToCustomer 

Si decides procesar una factura, puedes indicar en este campo si deseas o no que la factura se envíe por correo electrónico directamente al cliente. Esta función debe activarse primero en los ajustes de venta. 

En caso de que no desees que se envíe la factura, deja este campo en blanco o introduce el valor "False".

SalesInvoice: Lay-out

En este campo se puede elegir la disposición de la factura deseada. Si dejas este campo en blanco, se seleccionará el layout de la factura por defecto. 

SalesInvoice: Date 

La fecha de la factura 

SalesInvoice: DueDate 

La fecha de vencimiento 

SalesInvoice: PriceList 

En este campo puedes elegir la lista de precios deseada. Si dejas este campo en blanco, se seleccionará la lista de precios predeterminada. 

Si ofreces una combinación de precios con y sin IVA, es útil seleccionar una lista de precios con o sin IVA. En el caso de que el precio incluya el IVA, quedará bien registrado en la factura. Sin embargo, si el artículo está guardado en una lista de precios sin IVA y creas una factura con el mismo artículo en el módulo de facturación de Yuki, el precio se considerará sin IVA y se calculará y registrará en la factura. 

PRESTA ATENCIÓN

Los precios, las tasas de IVA y las cuentas de ingresos que se registran tienen prioridad.

SalesInvoice: Currency 

La moneda de la factura de venta. Si dejas este campo en blanco, se seleccionará la moneda predeterminada "EUR". 

Si no se registra ninguna lista de precios, se seleccionará la lista de precios predeterminada. Si esta lista no está configurada en una moneda extranjera, recibirás la siguiente notificación: "La moneda de la lista de precios "EUR" no coincide con la de la factura".

Si la divisa difiere de la divisa extranjera de la lista de precios, recibirás la siguiente notificación: "La divisa de la lista de precios "USD" no coincide con la de la factura".

Si deja el campo "Currency" en blanco pero seleccionas una lista de precios en una moneda extranjera, recibirás la siguiente notificación: "La moneda de la lista de precios "USD" no coincide con la de la factura".

SalesInvoice: ProjectID 

En este campo se puede introducir el ID del proyecto al que se quiere vincular el documento. Registrar este parámetro hace que el parámetro "ProjectID" sea irrelevante. El Proyecto Yuki tiene que ser habilitado de antemano en el contrato. 

SalesInvoice: ProjectCode 

En este campo se puede introducir el código del proyecto al que se quiere vincular el documento. Este parámetro sólo es relevante si no se indica el parámetro "ProjectID". El Proyecto Yuki tiene que ser habilitado de antemano en el contrato. 

Salesinvoice: Remarks 

La información introducida no se registrará en la factura, sino que se guardará como un comentario y se adjuntará a la factura de venta.

Contact: Contact 

En los campos de contacto se registrará el contacto/cliente de la factura. Yuki buscará primero un contacto existente en la libreta de direcciones. Yuki buscará: 

Código de contacto en el campo "Código de contacto" (en caso de que se registre uno). 

Nombre completo en el campo "FullName" (en caso de que no se encuentre o se registre el código de contacto)

Yuki creará un nuevo contacto si no se encuentra un contacto existente. 

Contact: found by ContactCod  (en la tarjeta de contacto)

Si se utiliza un código de contacto, los detalles de la dirección de un contacto existente siempre se sobrescribirán con el valor actual del archivo fuente XML. 

Para evitar que un campo sea sobrescrito, el elemento puede ser eliminado del archivo fuente XML 

Para ello, el elemento debe ser registrado como un nodo vacío (por ejemplo, <CocNumber />). 

Contact: found by FullName  (nombre o nombre de la empresa en la tarjeta de contacto)

Si te encuentras un contacto con el mismo nombre, sólo los campos que se dejen en blanco para ese contacto se completarán con los datos del archivo fuente XML.

Para los datos de la dirección se aplica la misma regla de que los datos sólo se completarán si coinciden con los datos existentes.

        Por ejemplo, la dirección "Dorpstraat 40, Ons Dorp" se completará con "Dorpstraat 40, 1234 XX, Ons Dorp" en caso de que la dirección y la ciudad sean las mismas y el código postal también se registre en el archivo XML. 

Contact: EmailAddress 

Sólo puedes introducir una dirección de correo electrónico. Esta dirección se guardará en la tarjeta de contacto del cliente y se registrará como tipo "Factura". Si esta dirección cambia, se puede registrar con una nueva factura a través del servicio web. La antigua dirección se configurará como tipo "Otro" y la nueva dirección recibirá el tipo "Factura".

Contact: BankAccount

En caso de que se registre una cuenta bancaria, ésta se guardará en la tarjeta de contacto del cliente. El número de cuenta también se utilizará como número de cuenta para esta factura. Por lo tanto, es posible que se registren varios números de cuenta para un cliente. 

Contact: BIC 

En caso de que se registre un código BIC, este código junto con el número de cuenta se guardará en la tarjeta de contacto del cliente. El número de cuenta y el código BIC también se utilizarán como número de cuenta para esta factura.

PRESTA ATENCIÓN

También es posible crear cuentas bancarias en el extranjero.

InvoiceLine: Description 

La descripción de la línea de la factura. Si este campo se deja en blanco o no se muestra, se utiliza la descripción del campo "Descripción del producto". 

InvoiceLine: Remarks 

Esta es una descripción extra que puede ser registrada para cada línea de la factura. El texto se colocará como una nueva línea alineada debajo de la línea de la factura actual. 

ATENCIÓN AL PAGO

Una línea nueva se crea con el código &#13;

InvoiceLine: ProductQuantity 

La cantidad de la posición de ventas descrita en la línea de la factura.

InvoiceLine: LineAmount 

En este campo se puedes introducir un importe de línea. El importe se calculará con el número de artículos de venta (ProductoCantidad) y el precio (Producto/Precio de venta). Si /Producto/VATIncluido es igual a "Verdadero", el importe incluye el IVA. En caso contrario, el importe no incluye el IVA. 

PRESTA ATENCIÓN

No recomendamos usar este campo. ¡Difiere de los métodos de cálculo de Yuki!

InvoiceLine: LineVATAmount 

En este campo puedes introducir una línea de importe de IVA. El importe se calculará con el importe de la línea y el porcentaje de IVA seleccionado. 

PRESTA ATENCIÓN

No recomendamos usar este campo. ¡Difiere de los métodos de cálculo de Yuki!

Product: Description 

La descripción de un artículo de venta con una longitud máxima de 60 caracteres. Las descripciones más largas se acortarán. Esta descripción tiene que ser única. 

Si el artículo de venta no puede ser encontrado en Yuki, un nuevo artículo de venta será creado por medio de los detalles encontrados en el archivo fuente XML. Si el campo "InvoiceLine:Description" se deja en blanco, el campo "Product:Description" se imprimirá en la factura.

Product: Reference 

La referencia de un artículo de venta con una longitud máxima de 40 caracteres. Las referencias más largas se acortarán. Esta referencia tiene que ser única. 

Product: Category 

Este campo puede utilizarse en el futuro para asignar categorías. Actualmente sólo se permiten los valores "NULL" y "13" (13 = categoría artículos de venta). Este campo es obligatorio. 

Product: VATPercentage  

El precio de venta de un artículo de venta. Si los artículos de venta ya están creados y pueden encontrarse mediante la descripción/referencia, este campo puede dejarse en blanco o registrarse con un valor 0. 

Yuki sólo utilizará los datos del archivo XML si los campos "Precio de venta", "Tipo de IVA" y "Porcentaje de IVA" están registrados, . De lo contrario, la información será copiada de la lista de precios. 

Si falta uno de los tres elementos, el artículo de venta siempre se puede encontrar en la lista de precios. Esta información es necesaria para registrar el artículo en la factura. Por lo tanto, no se puede crear un artículo de venta en la lista de precios sin esta información.

Product: VATIncluded 

El porcentaje de IVA de un artículo de venta. Este campo se utiliza en combinación con el campo 'VATType' para calcular el porcentaje de IVA. Si no existe el tipo de IVA, no se puede crear la factura. 

Product: VATIncluded 

En este campo se indica si el precio de venta incluye o no el IVA. Este campo se utiliza en combinación con los campos "Precio de venta" y "Tipo de IVA" para calcular el importe del IVA y el precio de venta. 

De forma predeterminada, el valor se fijará en "Falso" si este campo se deja en blanco en combinación con el precio de venta.

Valor "Falso" = precio de venta sin IVA. Valor "Verdadero" = precio de venta con IVA incluido.

Product: VATType 

En este campo puede seleccionar el tipo de IVA de un artículo de venta. Este campo se utiliza en combinación con los campos "Precio de venta" y "Tipo de IVA" para calcular el importe del IVA y el precio de venta. Las combinaciones posibles de porcentaje de IVA y tipos de IVA son: 

Tipo IVA         Porcentaje          Descripción

Descripción del IVA: Observaciones

Este campo puede ser usado en combinación con el 'VATType 8'. Esto no es obligatorio. La descripción del IVA de cada tipo se puede encontrar en la configuración del IVA de tu dominio.

Producto: Código cuenta contable 

El código de las cuentas del libro mayor en Yuki: 

Si el artículo de venta aún no está registrado en Yuki y este campo se deja en blanco o contiene un valor inválido (el número de cuenta del libro mayor inactivo también es inválido), se utilizará la cuenta del libro mayor por defecto con el código '700000 ventas de bienes'. 

Si el artículo de venta ya está registrado en Yuki y este campo se deja en blanco, se utilizará la cuenta del libro mayor que esté vinculada al artículo de venta en Yuki. 

 Si el artículo de venta ya está registrado en Yuki y este campo contiene un valor válido, se utilizará la cuenta de libro mayor que coincida con el valor del GLAccountCode. Además, el número de cuenta del libro mayor que está vinculado al artículo de venta existente no se ajustará. 

Producto: Observaciones

Este comentario se añadirá al artículo de venta en Yuki y no se mostrará en la factura.