Documentación para integración con servicios Sovos
Inicio

Addenda OXXO

OXXO

Tramas de archivo de integración

ADDENDA|OXXO|<Clase Documento>|<Plaza>|<Tipo de Proveedor>|<Tipo de Localización>|<Folio Pago>|<Orden de Compra>|<GLN Emisor>|<GLN Receptor>|<Monto Descuento 0>|<Tipo de Descuento 0>|<Monto Descuento 1>|<Tipo de Descuento 1>|<Monto Descuento 2>|<Tipo de Descuento 2>|<Monto Descuento 3>|<Tipo de Descuento 3>|<Tipo Validacion>
ADDENDA|OXXO|detalle|<Pedido Adicional>|<Numero de Remision>|<Fecha Entrega>|<CR de Tienda>|<Nombre Tienda>|<Identificador del Producto>|<Porcentaje de IVA>|<Monto del IVA>|<Porcentaje de IEPS 1>|<Monto de IEPS 1>|<Porcentaje de IEPS 2>|<Monto de IEPS 2>|<Porcentaje de IEPS 3>|<Monto de IEPS 3>

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 Clase Documento Atributo requerido para indicar el tipo o clase de documento relacionado. Los valores porsibles son: 1 para Factura, 2 para Nota de Cargo, 3 para Nota de Crédito. Lista de valores permitidos:
  • 1 (Factura)
  • 2 (Nota de cargo)
  • 3 (Nota de crédito)
 Requerido
2 Plaza Identificador de la plaza OXXO, el formato es 99AAA. Corresponde al CR superior de la plaza, los proveedores de tiendas lo pueden tomar del folio de pago. Tiene que ser de 5 caracteres alfanuméricos. Expresión Regular:
^[0-9A-Z]{5}$

 Requerido
3 Tipo de Proveedor Tipo de proveedor. Valores posibles: 01 para Directo, 02 para CEDIS, 03 para Activo Fijo, 04 para Servicios, 05 para Intercompañia Lista de valores permitidos:
  • 1 (Directo)
  • 2 (CEDIS)
  • 3 (Activo Fijo)
  • 4 (Servicios)
  • 5 (Intercompañia)
 Requerido
4 Tipo de Localización Tipo de Localización. Valores posibles: T para Tienda, C para CEDIS, P para Plaza Lista de valores permitidos:
  • T (Tienda)
  • C (CEDIS)
  • P (Plaza)
 Opcional
5 Folio Pago Número de Folio de pago que agrupa las compras semanales de Lunes a Domingo. Es requerido para proveedores Directos (01) y de localización Tienda (T). Tipo de Dato:
string

 Opcional
6 Orden de Compra Orden de compra de OXXO, es requerido solo cuando el tipo de localización es igual a C (CEDIS). 10 caracteres alfanuméricos. Expresión Regular:
^[0-9a-zA-Z]{10}$

 Opcional
7 GLN Emisor GLN del emisor del CFD . GLN (Global Localization Number). Es requerido solo para proveedores de tipo 01 y 02. Este número lo asigna la AMECE a aquellos proveedores que están afiliados. 13 caracteres alfanuméricos. Expresión Regular:
^[A-Za-z0-9]{13}$

 Opcional
8 GLN Receptor GLN del receptor del CFD. El GLN (Global Localization Number) de OXXO es: 7507003300005. Es requerido solo para proveedores de tipo 01 y 02. Expresión Regular:
^[A-Za-z0-9]{13}$

 Opcional
9 Monto Descuento 0 Importe de descuento global del tipo señalado en el atributo, tipoDescuento 0. Valor numérico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
10 Tipo de Descuento 0 Clave del tipo de descuento. Valores posibles: 001 para Distribución, 002 para Pronto Pago, etc. Lista de valores permitidos:
  • 001 (Distribución)
  • 002 (Pronto pago)
 Requerido
11 Monto Descuento 1 Importe de descuento global del tipo señalado en el atributo, tipoDescuento 1. Valor numérico de maximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
12 Tipo de Descuento 1 Clave del tipo de descuento. Valores posibles: 001 para Distribución, 002 para Pronto Pago, etc. Lista de valores permitidos:
  • 001 (Distribución)
  • 002 (Pronto pago)
 Requerido
13 Monto Descuento 2 Importe de descuento global del tipo señalado en el atributo, tipoDescuento 2. Valor numerico de máximo 2 decmales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
14 Tipo de Descuento 2 Clave del tipo de descuento. Valores posibles: 001 para Distribución, 002 para Pronto Pago, etc. Lista de valores permitidos:
  • 001 (Distribución)
  • 002 (Pronto pago)
 Requerido
15 Monto Descuento 3 Importe de descuento global del tipo señalado en el atributo, tipoDescuento 3. Valor numérico de máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
16 Tipo de Descuento 3 Clave del tipo de descuento. Valores posibles: 001 para Distribución, 002 para Pronto Pago, etc. Lista de valores permitidos:
  • 001 (Distribución)
  • 002 (Pronto pago)
 Requerido
17 Tipo Validacion Tipo de validación comercial a realizar, el valor siempre deberá ser 1, proveedores de servicio deberán señalar valor 5. Lista de valores permitidos:
  • 1 (Valor default)
  • 5 (Valor para proveedor de servicio)
 Opcional

Articulos

Descripción: Enlista los conceptos cubiertos por el comprobante.

Obligatoriedad: Esta sección es requerida.

Detalle

(Articulos >> Detalle)

Descripción: Información detallada de un bien o servicio amparado en el comprobante.

Obligatoriedad: Esta sección es requerida.

Esta sección es repetible.

Posición Nombre Descripción Restricciones Obligatoriedad
1 detalle Debe ser siempre el valor: detalle. Información detallada de un bien o servicio amparado en el comprobante.
2 Pedido Adicional Número del pedido adicional. Es requerido solo cuando el tipo de localización es igual a Tienda (T). Maximo 10 caracteres. Expresión Regular:
^.{0,10}$

 Opcional
3 Numero de Remision Número de la remisión. Puede proporcionarse cuando el tipo de localización es igual a Tienda (T). Máximo 6 caracteres alfanuméricos. Expresión Regular:
^[A-Za-z0-9]{0,6}$

 Opcional
4 Fecha Entrega Fecha de entrega de la mercancía. El formato para este dato es aaaa-mm-dd. Es requerido cuando el tipo de proveedor es Directo (01) o CEDIS (02). Tipo de Dato:
date

 Opcional
5 CR de Tienda CR de Tienda. Requerido cuando el tipo de localización es igual a Tienda (T). máximo 5 caracteres alfanuméricos. Expresión Regular:
^[0-9a-zA-Z]{5}$

 Opcional
6 Nombre Tienda Lugar de entrega. Nombre de la sucursal o CEDIS donde se entrega la mercancia. Es requerido cuando el tipo de proveedor es Directo (01) o CEDIS (02). Máximo 30 caracteres. Expresión Regular:
^.{0,30}$

 Opcional
7 Identificador del Producto Identificador del producto. SKU. Es requerido cuando el tipo de proveedor es Directo (01) o CEDIS (02) Expresión Regular:
^[A-Za-z0-9 _.°,!"'/$?()#=+*-]{0,14}$

 Opcional
8 Porcentaje de IVA Porcentaje de IVA aplicable al artículo. Valor numérico con un máximo de 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
9 Monto del IVA Monto del IVA del artículo. Valor numérico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
10 Porcentaje de IEPS 1 Porcentaje de IEPS aplicable al artículo. Valor numérico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
11 Monto de IEPS 1 Monto de IEPS aplicable al artículo. Valor numerico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
12 Porcentaje de IEPS 2 Porcentaje de IEPS aplicable al artículo. Valor numerico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
13 Monto de IEPS 2 Monto de IEPS aplicable al artículo. Valor numerico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
14 Porcentaje de IEPS 3 Porcentaje de IEPS aplicable al artículo. Valor numerico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional
15 Monto de IEPS 3 Monto de IEPS aplicable al artículo. Valor numerico con máximo 2 decimales. Expresión Regular:
^[0-9]+(\.[0-9]{1,2})?$

 Opcional