Documentación para integración con servicios Sovos
Inicio

Addenda Vitro

Vitro

Tramas de archivo de integración

ADDENDA|Vitro|<Tipo de entidad>
ADDENDA|Vitro|ORDERIDENTIFICATION|<Identificación de referencia>
ADDENDA|Vitro|ADDITIONALINFORMATION|<Código>|<Identificador>
ADDENDA|Vitro|DELIVERYNOTE|<Identificador de referencia.>
ADDENDA|Vitro|BUYER|<Número global de localización (GLN)>
ADDENDA|Vitro|SELLER|<Número global de localización (GLN)>|<Identificación secundaria del proveedor>|<type>
ADDENDA|Vitro|ALLOWANCECHARGE|<Indicador de cargo o descuento>|<Imputación de descuento o cargo>
ADDENDA|Vitro|MONETARYAMOUNT|<Tarifa>|<Porcentaje>
ADDENDA|Vitro|LINEITEM|<GTIN>|<Idioma>|<Monto>|<Monto>|<Referencia>
ADDENDA|Vitro|TRADEITEMTAX|<Tipo de arancel.>|<Numero de identificación del impuesto.>|<Porcentaje del impuesto.>|<Monto del impuesto.>|<Identificador de impuesto.>
ADDENDA|Vitro|TOTALLINEAMOUNT|<Importe bruto>|<Importe neto>
ADDENDA|Vitro|TOTALAMOUNT|<Monto>
ADDENDA|Vitro|TOTALALLOWANCECHARGE|<Tipo de descuento o cargo.>|<Monto>

Estructura de Campos de la Addenda

Datos Generales

Descripción: Datos generales de la addenda.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 Tipo de entidad Identificación del tipo de mensaje Valores Lista de valores permitidos:
  • INVOICE (Factura)
  • DEBIT_NOTE (Nota de débito)
  • CREDIT_NOTE (Nota de crédito)
  • LEASE_RECEIPT (Recibo de arrendamiento)
  • HONORARY_RECEIPT (Recibo de honorarios)
  • PARTIAL_INVOICE (Comprobante de pago a plazos)
  • TRANSPORT_DOCUMENT (Carta porte)
 Requerido

Identificación de Orden

Descripción: Identificación de Orden.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 ORDERIDENTIFICATION Debe ser siempre el valor: ORDERIDENTIFICATION. Identificación de Orden.
2 Identificación de referencia Número de pedido (comprador) a la que hace referencia la factura. Expresión Regular:
^[a-zA-Z0-9]{1,35}$

 Requerido

Información Adicional

Descripción: Informa de referencias adicionales a nivel global

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 ADDITIONALINFORMATION Debe ser siempre el valor: ADDITIONALINFORMATION. Informa de referencias adicionales a nivel global
2 Código Identificador de la referencia adicional. Lista de valores permitidos:
  • ACE (Numero de documento(Reemisión))
  • IV (Número de Factura)
  • AWR (Numero de documento que se reemplaza)
 Requerido
3 Identificador Número de referencia adicional. Expresión Regular:
^[a-zA-Z0-9]{1,35}$

 Requerido

Nota de entrega

Descripción: Nota de entrega.

Obligatoriedad: Esta sección es opcional.

Posición Nombre Descripción Restricciones Obligatoriedad
1 DELIVERYNOTE Debe ser siempre el valor: DELIVERYNOTE. Nota de entrega.
2 Identificador de referencia. Numero de folio. Número emitido por el comprador cuando recibe la mercancía que es facturada. Expresión Regular:
^[a-zA-Z0-9]{1,35}$

 Requerido

Comprador.

Descripción: Comprador.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 BUYER Debe ser siempre el valor: BUYER. Comprador.
2 Número global de localización (GLN) Se indica el número global de localización (GLN) del vendedor. (Hasta 13 números) Expresión Regular:
^[0-9]{13}$

 Requerido

Vendedor.

Descripción: Vendedor.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 SELLER Debe ser siempre el valor: SELLER. Vendedor.
2 Número global de localización (GLN) Se indica el número global de localización (GLN) del vendedor. (Hasta 13 números) Expresión Regular:
^[0-9]{13}$

 Opcional
3 Identificación secundaria del proveedor Identificación secundaria del proveedor. Expresión Regular:
^[a-zA-Z0-9]{1,35}$

 Requerido
4 type Código para identificar qué tipo de identificación secundaria se le asignó al proveedor Lista de valores permitidos:
  • SELLER_ASSIGNED_IDENTIFIER_FOR_A_PARTY
  • IEPS_REFERENCE
 Requerido

Cargos o descuentos

Descripción: Etiqueta que contendrá la información de los cargos o descuentos globales por factura.

Obligatoriedad: Esta sección es opcional.

Esta sección es repetible.

Posición Nombre Descripción Restricciones Obligatoriedad
1 ALLOWANCECHARGE Debe ser siempre el valor: ALLOWANCECHARGE. Etiqueta que contendrá la información de los cargos o descuentos globales por factura.
2 Indicador de cargo o descuento Indicador de cargo o descuento. ALLOWANCE_GLOBAL,CHARGE_GLOBAL Lista de valores permitidos:
  • ALLOWANCE_GLOBAL
  • CHARGE_GLOBAL
 Requerido
3 Imputación de descuento o cargo Imputación de descuento o cargo. Información del por qué se genera el cargo o descuento. Lista de valores permitidos:
  • BILL_BACK (Reclamación)
  • OFF_INVOICE (Fuera de factura)
 Requerido

Cantidad monetaria o porcentaje

(Cargos o descuentos >> Cantidad monetaria o porcentaje)

Descripción: Cantidad monetaria o porcentaje.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 MONETARYAMOUNT Debe ser siempre el valor: MONETARYAMOUNT. Cantidad monetaria o porcentaje.
2 Tarifa Tarifa Tipo de Dato:
decimal

 Requerido
3 Porcentaje Porcentaje de descuento que se está aplicando según se ha indicado en el campo anterior a toda la factura. Tipo de Dato:
decimal

 Requerido

lineItems

Descripción: lineItems

Obligatoriedad: Esta sección es requerida.

Línea de artículo

(lineItems >> Línea de artículo)

Descripción: Comienza el detalle

Obligatoriedad: Esta sección es requerida.

Esta sección es repetible.

Posición Nombre Descripción Restricciones Obligatoriedad
1 LINEITEM Debe ser siempre el valor: LINEITEM. Comienza el detalle

Identificación del artículo comercial

(lineItems >> Línea de artículo >> Identificación del artículo comercial)

Descripción: Comienzo de la identificación de cada artículo

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 GTIN Código EAN del artículo solicitado Expresión Regular:
^[0-9]{13}$

 Opcional

tradeItemDescriptionInformation

(lineItems >> Línea de artículo >> tradeItemDescriptionInformation)

Descripción: Inicia la descripción del artículo

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 Idioma Idioma en que esta la descripción del articulo Lista de valores permitidos:
  • ES (Español)
  • EN (Ingles)
 Opcional

Precio bruto

(lineItems >> Línea de artículo >> Precio bruto)

Descripción: Inicia la declaración del precio bruto

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 Monto Precio Bruto del artículo sin incluir descuento ni cargos. Tipo de Dato:
decimal

 Requerido

Precio neto

(lineItems >> Línea de artículo >> Precio neto)

Descripción: Inicia la declaración del precio neto

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 Monto Precio neto de cada artículo. Tipo de Dato:
decimal

 Requerido

Modelo del artículo

(lineItems >> Línea de artículo >> Modelo del artículo)

Descripción: Información adicional de referencia.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 Referencia Referencia. Requerido

Detalle delos impuestos

(lineItems >> Línea de artículo >> Detalle delos impuestos)

Descripción: Nodo padre donde se comenzará a detallar los impuestos por cada línea de artículo

Obligatoriedad: Esta sección es opcional.

Posición Nombre Descripción Restricciones Obligatoriedad
1 TRADEITEMTAX Debe ser siempre el valor: TRADEITEMTAX. Nodo padre donde se comenzará a detallar los impuestos por cada línea de artículo
2 Tipo de arancel. Tipo de arancel, impuesto o cuota. Lista de valores permitidos:
  • GST (IEPS)
  • VAT (Impuesto sobre el valor agregado)
  • LAC (ISR)
 Requerido
3 Numero de identificación del impuesto. Numero de identificación del impuesto. Expresión Regular:
^[a-zA-Z0-9]{1,20}$

 Requerido
4 Porcentaje del impuesto. Porcentaje del impuesto. Expresión Regular:
^[0-9]{1,5}$

 Requerido
5 Monto del impuesto. Monto del impuesto. Expresión Regular:
^[0-9]{1,5}$

 Requerido
6 Identificador de impuesto. Identificador de impuesto retenido o transferido Lista de valores permitidos:
  • TRANSFERIDO
  • RETENIDO
 Requerido

Total Importes monetarios

(lineItems >> Línea de artículo >> Total Importes monetarios)

Descripción: Importes monetarios por línea de articulo.

Obligatoriedad: Esta sección es requerida.

Posición Nombre Descripción Restricciones Obligatoriedad
1 TOTALLINEAMOUNT Debe ser siempre el valor: TOTALLINEAMOUNT. Importes monetarios por línea de articulo.
2 Importe bruto Indica que se definirá el importe bruto. Expresión Regular:
^([0-9]{1,20})+(\.[0-9]{1,2})?$

 Requerido
3 Importe neto Indica que se definirá el importe neto. Expresión Regular:
^([0-9]{1,20})+(\.[0-9]{1,2})?$

 Requerido

Monto total

Descripción: Indica que se definirá el monto total de las líneas de artículos..

Obligatoriedad: Esta sección es opcional.

Posición Nombre Descripción Restricciones Obligatoriedad
1 TOTALAMOUNT Debe ser siempre el valor: TOTALAMOUNT. Indica que se definirá el monto total de las líneas de artículos..
2 Monto Monto total de las líneas de artículos Requerido

Tipo de descuento o cargo

Descripción:

Obligatoriedad: Esta sección es opcional.

Posición Nombre Descripción Restricciones Obligatoriedad
1 TOTALALLOWANCECHARGE Debe ser siempre el valor: TOTALALLOWANCECHARGE.
2 Tipo de descuento o cargo. Indicador de cargos o descuentos consolidados. ALLOWANCE= , CHARGE= Lista de valores permitidos:
  • ALLOWANCE (Descuento)
  • CHARGE (Cargo)
 Requerido
3 Monto Monto total de los cargos o descuentos. Expresión Regular:
^([0-9]{1,20})+(\.[0-9]{1,2})?$

 Requerido