Integración de pedidos
Introducción
Cada vez que un pedido es correctamente pagado, la Tol genera un JSON con los datos del pedido y lo sube al servidor de archivos integrado.
En este documento se recogen las interfaces estándar de pedidos
El fichero se nombrará con el número de pedido.
Tipos de integración
La integración de los pedidos con el cliente se puede realizar de tres formas diferentes:
- Envío mediante servidor de archivos
- Envío del pedido mediante WS
- Envío del pedido mediante email
Adicionalmente el cliente puede reenviar los pedidos o descargarlos en formato json desde el back-office.
Formato del pedido
La información estará contenida en un objeto JSON con el siguiente formato
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Datos Pedido “datosPedido” | Datos relacionados con el pedido | Tipo Pedido | Sí |
| Datos Usuario “datosUsuario” | Datos relacionados con el usuario | Tipo Usuario | Sí |
| Dirección Usuario “direccionUsuario” | Dirección del usuario | Tipo Dirección | Sí |
| Dirección Entrega “direccionEntrega” | Dirección donde se enviará el pedido en caso de entrega a domicilio | Tipo Dirección | Sí |
| Datos Factura “direccionFactura” | Datos relacionados a la factura | Tipo Factura | No |
| Productos “productos” | Lista de los productos del pedido | Lista de Tipo Producto | Sí |
| Pago “datosPago” | Datos de pago que se han aplicado al pedido | Tipo Pago | Si |
| Versión JSON “versionJ” | Versión correspondiente a la estructura del JSON | Literal (50 caracteres máx.) | Sí |
Tipo Pedido
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código “codigo” | Código generado automáticamente que identifica distintivamente el pedido | Numérico entero | Sí |
| Código zona “codigoZona” | Código de la zona | Numérico entero | Sí |
| Id Zona Envio “idZonaEnvio” | Zona de envio Id | Literal (50 caracters máx.) | Sí |
| Código tienda física “codigoTiendaFisica” | Código de la tienda física | Literal (50 caracteres máx.) | Sí |
| Tipo de entrega “tipoEntrega” | Indicador si la entrega se realizará en tienda o a domicilio | Literal (1 carácter máx.) “T” à Tienda “D” àDomicilio “L” à Locker | Sí |
| Fecha “fecha” | Fecha en la que se ha realizado el pedido | Fecha (dd/mm/aaaa) | Sí |
| Hora “hora” | Hora en la que se ha realizado el pedido | Hora (HH:MM) | Sí |
| Idioma “idioma” | Identificador del idioma (ISO 639-1) | Literal (2 caracteres máx.) | Sí |
| Divisa “divisa” | Código que identifica la divisa (ISO-4217) | Literal (3 caracteres máx.) | Sí |
| IVA picking “ivaPicking” | IVA correspondiente al importe de la preparación del pedido | Numérico | Sí |
| IVA transporte “ivaTransporte” | IVA correspondiente al importe del envío del pedido a domicilio | Numérico | Sí |
| Importe “importe” | Importe total del pedido | Numérico | Sí |
| Importe incrementado “importeIncrementado” | Importe incrementado, margen que agrega al importe que se aplica según reglas del cliente. | Numérico | Si |
| Líneas pedido “lineasPedido” | Número de líneas del pedido | Numérico entero | Sí |
| Identificador franja “idFranja” | Código que identifica unívocamente la franja | Literal (50 caracteres máx.) | No |
| Fecha entrega “fechaEntrega” | Fecha de entrega seleccionada | Fecha (dd/mm/aaaa) | Sí |
| Hora inicio franja “horaInicioFranja” | Hora de inicio de la franja de entrega seleccionada | Hora (HH:MM) | Sí |
| Hora fin franja “horaFinFranja” | Hora fin de la franja de entrega seleccionada | Hora (HH:MM) | Sí |
| ¿Es empleado? “esEmpleado” | Indicador si el usuario es empleado | Booleano (1,0) | Sí |
| Descuento empleado “descuentoEmpleado” | Descuento aplicado al importe total del pedido si el usuario es empleado | Numérico | No |
| Acepta sustituciones “sustituciones” | Indicador si el cliente acepta sustituciones en este pedido. Valores definibles por instalación | Numerico entero | No |
| Recoge otra persona “recogeOtro” | Indicador si el pedido lo recogerá otra persona | Booleano (1,0) | No |
| Quien recoge “quienRecoge” | Documento de identidad de la persona que recoge el pedido y no es la misma que ha realizado el pedido | Literal (30 caracteres máx.) | No |
| Observaciones “observaciones” | Observaciones adicionales indicadas por parte del usuario | Literal (1024 caracteres máx.) | No |
| Gastos de entrega o manipulación “gastoEntregaOManipulacion“ | Importe total de los gastos de entrega o manipulación aplicados al pedido. Incluye posibles descuentos de cupones u ofertas. | Numérico decimal (formato 0.00) | No |
| Gastos de entraga o manipulación SIN promoción “gastoEntregaOManipulacionSinPromocion” | Importe total de los gastos de entrega o manipulación aplicados al pedido antes de aplicar descuentos de cupones u ofertas. | Numérico decimal (formato 0.00) | No |
| Descuento inmediato en portes “descuentoInmediatoPortes” | Importe descontado a los gastos de envío o manipulación | Numérico decimal (formato 0.00) | No |
| Descuento diferido en portes “descuentoDiferidoPortes” | Importe a descontar en diferido a los gastos de envío o manipulación. Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Descuento inmediato total “descuentoInmediatoTotal” | Importe descontado al concepto “total” del pedido. Es la suma de los descuentos generados a partir de cupones u ofertas que únicamente aplican al total del pedido. | Numérico decimal (formato 0.00) | No |
| Descuento diferido total “descuentoDiferidoTotal” | Importe a descontar en diferido para aplicar al total del pedido. Es la suma de los descuentos generados a partir cupones u ofertas que únicamente aplican al total ldel pedido. Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Total productos con promociones no cruzadas “totalProductosConPromocionesNoCruzadas” | Importe totalizado de la suma de los precios de los productos con promociones no cruzadas. | Numérico decimal (formato 0.00) | No |
| Total productos con promociones conjunto “totalProductosConPromocionesConjunto” | Importe totalizado de la suma de los precios de los productos donde aplica alguna promoción de conjunto (pueden ser cruzadas o no cruzadas) | Numérico decimal (formato 0.00) | No |
| Total productos “totalProductos” | Importe totalizado de los productos. No contempla cupones u ofertas | Numérico decimal (formato 0.00) | Si |
| Descuento inmediato en producto cruzado “descuentoProductoInmediatoCruzado” | Importe descontado resultante de los productos con cupón u oferta del tipo cruzada. | Numérico decimal (formato 0.00) | No |
| Descuento diferido en producto cruzado “descuentoProductoDiferidoCruzado” | Importe a descontar en diferido resultante de los productos con cupón u oferta del tipo cruzado. Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Subtotal “subtotal” | Importe total de los productos aplicando descuentos y gastos de entrega (sin promoción). | Numérico decimal (formato 0.00) | Si |
| Total “total” | Importe total del pedido, lo que pagará el cliente si no tiene cupones del tipo “dondeAplicaPromocion: 8 (importeNeto)” | Numérico decimal (formato 0.00) | Si |
| Importe neto “importeNeto” | Importe total que pagará el cliente. Incluye todos los cupones y ofertas | Numérico decimal (formato 0.00) | Si |
| Descuento inmediato importe neto “descuentoInmediatoImporteNeto” | Importe total descontado resultante de cupones u ofertas que sólo aplican a importe neto | Numérico decimal (formato 0.00) | Si |
| Descuento diferido importe neto “descuentoDiferidoImporteNeto” | Importe total a descontar en diferido resultante de cupones u ofertas que sólo aplican a importe neto | Numérico decimal (formato 0.00) | Si |
| Descuento inmediato en productos “descuentoInmediatoProductos” | Importe total descontado resultante de cupones u ofertas que sólo aplican a producto. Incluye todos los productos, pudiendo estar o no en conjunto (agrupaciones, lotes, categorías, jerarquía o producto) | Numérico decimal (formato 0.00) | No |
| Descuento diferido en productos “descuentoDiferidoProductos” | Importe total a descontar en diferido resultante de cupones u ofertas que sólo aplican a producto. Incluye todos los productos, pudiendo estar o no en conjunto (agrupaciones, lotes, categorías, jerarquía o producto). Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Descuento inmediato en productos no cruzados “descuentoProductosInmediatoNoCruzado” | Importe total descontado resultante de cupones u ofertas que sólo aplican a producto. Incluyen los productos contemplados en un conjunto (agrupaciones, lotes, categorías o jerarquía o producto) | Numérico decimal (formato 0.00) | No |
| Descuento diferido en productos no cruzados “descuentoProductosDiferidoNoCruzado” | Importe total a descontar en diferido resultante de cupones u ofertas que sólo aplican a producto. Incluyen los productos contemplados en un conjunto (agrupaciones, lotes, categorías o jerarquía o producto) Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Entrega en domicilio “entregaDomicilio” | Indicador si el pedido se entrega en domicilio 0 à Tienda 1 à Domicilio DEPRECATED. Se mantiene por compatibilidad con versiones anteriores. | Booleano | Si |
| Cupones aplicados “cupones” | Lista de cupones aplicados al importe total del pedido | Lista de Tipo Cupón | No |
| Ofertas aplicadas “ofertas” | Lista de ofertas aplicadas al importe total del pedido | Lista de Tipo Oferta | No |
Tipo Usuario
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código usuario “codigoUsuario” | Código que identifica al usuario distintivamente. | Literal (50 caracteres) | Sí |
| Email “email” | Correo electrónico del usuario | Literal (50 caracteres) | Sí |
| Nombre “nombre” | Nombre del usuario | Literal (50 caracteres) | Sí |
| Apellido1 “apellido1” | Primer apellido del usuario | Literal (50 caracteres) | Sí |
| Apellido2 “apellido2” | Segundo apellido del usuario | Literal (50 caracteres) | No |
| Sexo “sexo” | Sexo del usuario | Literal (1 carácter ) “H” à Hombre “M” àMujer | No |
| Tipo Documento “tipoDocumento” | Tipo de documento del usuario | Literal (20 carácter) CIF, NIF, PASAPORTE… | Sí |
| Número documento “numeroDocumento” | Número del documento identificativo del usuario | Literal (20 carácter.) | Sí |
| Fecha nacimiento “fechaNacimiento” | Fecha de nacimiento del usuario | Fecha (dd/mm/aaaa) | No |
| Nacionalidad “nacionalidad” | Nacionalidad del usuario | Literal (20 carácter ) | No |
| Teléfono 1 “telefono1” | Teléfono principal del usuario | Literal (20 carácter ) | Sí |
| Teléfono 2 “telefono2” | Teléfono alternativo del usuario | Literal (20 carácter ) | No |
| Desea SMS “deseaSMS” | Indicador de si el usuario quiere recibir un SMS con la confirmación del pedido | Booleano (1,0) | Sí |
| Desea correo “deseaCorreo” | Indicador de si el usuario quiere recibir un correo electrónico con la confirmación del pedido | Booleano (1,0) | Sí |
| Desea factura “deseaFactura” | Indicador si el usuario quiere que le adjunten la factura en el pedido | Booleano (1,0) | Sí |
| Tipo de usuario “tipoUsuario” | Tipo de usuario que realiza el pedido | Literal (1 carácter ) “P” à Particular “E” àEmpresa | Sí |
| Socio “socio” | Indicador de si el usuario es socio | Booleano (1,0) | Sí |
| Conectar en Nombre De "admiteConectarEnNombreDe" | Indica si el cliente puede conectar en nombre de | Booleano (1,0) | Sí |
| Código Cliente “codigoCliente” | Codigo que identifica el usuario en el cliente (tarjeta de socio por ejemplo) | Literal (50 caracteres) | No |
Tipo Dirección
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Tipo de vía “tipoVia” | Calle, Plaza, Avenida, etc. | Literal (50 caracteres) | Sí |
| Nombre vía “nombreVia” | Nombre de la vía | Literal (100 caracteres) | Sí |
| Anexo vía “anexoVia” | Anexo de la vía | Literal (50 caracteres) | No |
| Número “numero” | Numero 3, 4 BIS, etc. | Literal (20 caracteres) | Sí |
| Escalera “escalera” | Escalera: A, DERECHA, etc. | Literal (30 caracteres) | No |
| Piso “piso” | Piso 1, Principal, Entresuelo, etc. | Literal (30 caracteres) | No |
| Letra “letra” | Letra 1, A, etc. | Literal (30 caracteres) | No |
| Ascensor “ascensor” | El domicilio dispone de ascensor (0, 1) Configurable por instalación | Booleano (1,0) | No |
| CP “cp” | Código postal | Literal (5 caracteres) | Sí |
| Localidad “localidad” | Nombre de la localidad | Literal (100 caracteres) | Sí |
| Provincia “provincia” | Nombre de la provincia | Literal (100 caracteres) | Sí |
| País “codigoPais” | Codigo que identifica el pais (ISO-3166-1) | Numerico | Sí |
| Origen “origen” | Aplicación que ha generado el pedido | Literal (256 caracteres) | Sí |
Tipo Factura
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| CIF “cif” | CIF de la empresa | Literal (30 carácter ) | Sí |
| Razón social “razonSocial” | Razón social de la empresa | Literal (100 carácter) | Sí |
| Recargo equivalencia “recargoEquivalencia” | Indicador si el usuario quiere recargo de equivalencia en la factura | Booleano (1,0) | Sí |
| Dirección “direccion” | Dirección de la empresa | Tipo Dirección | Sí |
Tipo Producto
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código “codigo” | Código interno del producto en los sistemas del cliente | Literal (50 caracteres máx.) | Sí |
| Descripción larga “descripcionLarga” | Descripción larga del producto | Literal (255 caracteres máx.) | Sí |
| Tipo “tipo” | Numérico entero Tipo 1: Producto estándar Tipo 2: Producto al peso Tipo 3: Producto al peso que se vende por unidades | Sí | Sí |
| Cantidad “cantidad” | Cantidad pedida del producto. Para productos tipo 1 (estándar) -> unidades de producto. Para productos tipo 2 (al peso) -> kg./gr. Para productos tipo 3 (al peso por unidades) -> unidades de producto. | Numérico decimal (formato 0.00) | Sí |
| Unidad medida “unidadMedida” | Unidad de media en la cual se expresa la cantidad. Es el campo utilizado a nivel informativo kg./gr. | Literal (10 caracteres máx.) | Sí |
| Unidad medida del precio unitario “unidadMedidaPrecioUnitario” | Unidad de medida unitaria del producto. Es la que se usa para el cálculo del precio del producto en función de la cantidad seleccionada | Literal (10 caracteres máx) | No |
| Cantidad en modo conversión “conversionCantidad” | Cantidad pedida del producto en modo conversión. Por ejemplo 4 Uds en productos de Tipo 2 y 1.60Kg en productos de Tipo 3 | Numérico decimal (formato 0.00) | No |
| Unidad medida en modo conversión “conversionUnidadMedida” | Unidad medida en modo conversión. Por ejemplo 'Ud' en productos de Tipo 2 y 'Kg' en productos de Tipo 3 | Literal (10 caracteres máx) | No |
| Tipo IVA “tipoIva” | Tipo de IVA aplicado al producto | Numérico | No |
| IVA “iva” | Porcentaje de IVA aplicado al producto | Numérico | Sí |
| Grupo picking “grupoPicking” | Para la división de los pedidos en grupos de picking en el Backoffice | Numérico entero | Sí |
| Orden picking 1 “ordenPicking1” | Para la ordenación de los productos en la lista de picking dentro de su grupo | Numérico entero | No |
| Orden picking 2 “ordenPicking2” | Para la ordenación de los productos en la lista de picking dentro de su grupo | Numérico entero | No |
| Orden picking 3 “ordenPicking3” | Para la ordenación de los productos en la lista de picking dentro de su grupo | Numérico entero | No |
| Recurrente “recurrente” | Producto recurrente | Booleano (1,0) | Sí |
| Tipo preparación “tipoPreparacion” | Tipo de preparación del producto | Tipo preparación | No |
| Observaciones linea “observaciones” | Observaciones de la línea de producto. si hay “tipoPreparacion.descripcion” se concatena con la observación. Ejemplo: “tipoPreparacion.descripcion”: a filetes. “observaciones”: Por favor, en bandeja y separados por papel. Asi quedan las “observaciones” “a filetes–Por favor, en bandeja y separados por papel.” | Literal (512 caracteres máx.) | No |
| Precio unitario “precioUnitario” | Precio unitario del producto | Numérico decimal (formato 0.00) | Si |
| Precio unitario oferta “precioUnitarioOferta” | Falta ver como rellenarlo, ya que lo hemos de calcular y no sabemos como hacerlo | ||
| Nombre del tipo de producto “nombreTipoProducto” | Tipo de producto àEstándar àA peso àA peso por unidades | Literal (30 caracteres máx.) | Si |
| Formato “formato” | Formato de presentación del producto (“Cajas”, “Botellas”…) | Lista de Tipo Literal Multi-idioma (50 caracteres máx.) | No |
| Frecuencia “frecuencia” | Implementación a definir en cada cliente | Numérico entero | No |
| Precio final “precioFinal” | Precio final del producto antes de aplicar cupón u oferta | Numérico decimal (formato 0.00) | Si |
| Precio final con promociones “precioFinalConPromociones” | Precio final del producto una vez aplicados cupones u ofertas | Numérico decimal (formato 0.00) | Si |
| Diferido acumulado “diferidoAcumulado” | Importe a descontar en diferido al producto. Requerirá carga de un cupón | Numérico decimal (formato 0.00) | No |
| Descuento inmediato “descuentoInmediato“ | Importe descontado al producto | Numérico decimal (formato 0.00) | No |
| Cupones aplicados “cupones” | Lista de cupones aplicados al producto | Lista de Tipo Cupón | No |
| Ofertas aplicadas “ofertas” | Lista de ofertas aplicadas al producto | Lista de Tipo Oferta | No |
Tipo Preparación
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código “codigo” | Código interno del tipo de preparación Ejemplo: XXX | Literal (50 caracteres máx.) | Sí |
| Descripción “descripcion” | Descripción del tipo de preparación. Ejemplo: a filetes | Literal (255 caracteres máx.) | Sí |
Tipo Cupón
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código “codigo” | Código de cupón | Literal (30 caracteres máx.) | Si |
| Promoción “promocion” | Código de la promoción relacionada al cupón | Literal (50 caracteres máx.) | Si |
| Código promoción cliente “codigoPromocionCliente” | Código de la promoción del cliente | Literal (50 caracteres máx.) | No |
| Importe aplicado “importe” | Importe de descuento que ha generado el cupón. Este valor es excluyente con el campo porcentaje | Numérico decimal (formato 0.00) | No |
| Porcentaje descuento “porcentaje” | Porcentaje de descuento que se aplicará en la próxima compra. Este valor es excluyente con el campo es importe | Numérico decimal (formato 0.00) | No |
Tipo Oferta
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Código “codigo” | Código de la oferta | Literal (30 caracteres máx.) | Sí |
| Promoción “promocion” | Código de la promoción relacionada a la oferta | Literal (50 caracteres máx.) | Sí |
| Código promoción cliente “codigoPromocionCliente” | Código de la promoción del cliente | Literal (50 caracteres máx.) | No |
| Importe aplicado “importe” | Importe de descuento que ha generado la oferta. Este valor es excluyente con el campo porcentaje | Numérico decimal (formato 0.00) | No |
| Porcentaje descuento “porcentaje” | Porcentaje de descuento que se aplicará en la próxima compra. Este valor es excluyente con el campo importe | Numérico decimal (formato 0.00) | No |
Tipo Pago
Informa de los datos de pago que se han aplicado al pedido.
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Forma de pago “formaPago” | Identificador de la forma de pago seleccionada | Numérico entero 1 - REDSYS 5 - ADDON PAYMENTS 6 - SIMULADO 10 - FINARO | Sí |
| Otros datos “otrosDatosPago” | Otra información relativa al proveedor del pago o al pago. Variable en función del proveedor | Lista de Tipo Clave-Valor | No |
Lista de Tipo Clave-Valor
Informa de datos variables en función de la forma de pago:
| Campo “Nombre campo” | Descripción/Ejemplo | Formato | Oblig. |
|---|---|---|---|
| Nombre parametro “name” | Identificador del parámetro | Literal (30 caracteres) | Sí |
| Valor del parametro “value” | Valor del parámetro | Literal (256 caracteres) | Sí |
Ejemplos otros datos pagos para las plataformas de pago más comunes:
otrosDatosPago con formaPago Redsys.
| Campo “name” | Descripción/Ejemplo |
|---|---|
| Código autorización “codigoAutorizacion” | Código de autorización asociado al método de pago. → "12345" |
| Código comercio electrónico “codigoComercioElectronico” | Merchant Code de la zona seleccionada → "343644407" |
| Terminal comercio electrónico “TerminalComercioElectronico” | Número del terminal del comercio electrónico asociada a la zona → "001" |
| Proveedor Pago “proveedorPago” | Constantes según MetodoPago: REDSYS → "Redsys" |
| Tarjeta propia “tarjetaPropia” | Constantes según MetodoPago: REDSYS → 0 |
otrosDatosPago con formaPago Addon.
| Campo “name” | Descripción/Ejemplo |
|---|---|
| Código autorización “codigoAutorizacion” | Código de autorización asociado al método de pago. → "123456" |
| Código comercio electrónico “codigoComercioElectronico” | Merchant Code de la zona seleccionada → "merchantidtest" |
| Proveedor Pago “proveedorPago” | Constantes según MetodoPago: TARJETA_ADDON_PAYMENTS → "Addon" |
| Tarjeta propia “tarjetaPropia” | Constantes según MetodoPago: TARJETA_ADDON_PAYMENTS → 0 |
| Account “account” | Cuenta de referencia del método de pago. → "343075347" |
| pasRef “pasRef” | Respuesta de la pasarela de pago. → "15627512950891269" |
otrosDatosPago con formaPago Simulado.
| Campo “name” | Descripción/Ejemplo |
|---|---|
| Código autorización “codigoAutorizacion” | Código de autorización asociado al método de pago. → "SIMULADO" |
| Proveedor Pago “proveedorPago” | Constantes según MetodoPago: SIMULADO → "no definido" |
OtrosDatosPago con FormaPago Finaro.
| Campo “name” | Descripción/Ejemplo |
|---|---|
| Código autorización “codigoAutorizacion” | Código de autorización asociado al método de pago. → "123456" |
| Código comercio electrónico “codigoComercioElectronico” | Merchant Code de la zona seleccionada → "merchantidtest" |
| Proveedor Pago “proveedorPago” | Constantes según MetodoPago: TARJETA_FINARO_PAYMENTS → "no definido" |
| Tarjeta propia “tarjetaPropia” | Constantes según MetodoPago: TARJETA_FINARO_PAYMENTS → 0 |
| Tipo de operación “O” | tipo de operación realizada: TARJETA_FINARO_PAYMENTS → “2” |
| Tipo de transacción realizada “a9” | Tipo de transacción realizada: TARJETA_FINARO_PAYMENTS → “6” |
| Mes de caducidad “b3” | Mes de caducidad: TARJETA_FINARO_PAYMENTS → “12” |
| Año de caducidad “b4” | Año de caducidad: TARJETA_FINARO_PAYMENTS → “34” |
| El identificador de la transacción en source-gateway “z1” | El identificador de la transacción en source-gateway: TARJETA_FINARO_PAYMENTS → “XZZ018864b66f1abD8EY5L7MIOHHRCOT” |
| El identificador inicial de la transacción “z50” | El identificador inicial de la transacción: TARJETA_FINARO_PAYMENTS → “202221301000304” |
ANEXOS. Ejemplos json
Ejemplo alta pedido
{
"datosUsuario": {
"codigoUsuario": "usuario.prueba@aktios.com",
"email": "usuario.prueba@aktios.com",
"nombre": "Usuario",
"apellido1": "Prueba",
"apellido2": "Aktios",
"sexo": "H",
"tipoDocumento": "NIF",
"numeroDocumento": "12341234G",
"fechaNacimiento": "20/11/2019",
"nacionalidad": "ESPAÑA",
"telefono1": "633322211",
"telefono2": "9111111111",
"deseaSms": 1,
"deseaCorreo": 1,
"deseaFactura": 1,
"tipoUsuario": "P",
"socio": 1,
"codigoCliente": null,
"admiteConectarEnNombreDe": 1
},
"direccionUsuario": {
"tipoVia": "",
"nombreVia": "VIRGEN Mayor",
"anexoVia": "5",
"numero": "21",
"escalera": "Izquierda",
"piso": "Bajo",
"letra": "B",
"cp": "08006",
"localidad": "Barcelona",
"provincia": "Barcelona",
"codigoPais": 724
},
"direccionEntrega": {
"tipoVia": "Calle",
"nombreVia": "ZONA 14972",
"anexoVia": "",
"numero": "S/N",
"escalera": "",
"piso": "",
"letra": "",
"cp": "20301",
"localidad": "Irun",
"provincia": "Gipuzkoa",
"codigoPais": 724
},
"direccionFactura": null,
"datosPedido": {
"codigo": 1947,
"codigoZona": 14972,
"codigoTiendaFisica": "1556",
"tipoEntrega": "D",
"fecha": "16/07/2019",
"hora": "13:05",
"idioma": "es",
"divisa": "EUR",
"ivaPicking": 4.00,
"ivaTransporte": 4.00,
"importe": 0,
"cupones": [
{
"codigo": "21600467320190001497_CUPON_1",
"promocion": "21600467320190001497_CUPON_1",
"codigoPromocionCliente": "4674",
"importe": 15.00
},
{
"codigo": "21600467320190001497_CUPON_2",
"promocion": "21600467320190001497_CUPON_2",
"codigoPromocionCliente": "4674",
"importe": 0.26
},
{
"codigo": "21600467320190001497_CUPON_3",
"promocion": "21600467320190001497_CUPON_3",
"codigoPromocionCliente": "4674",
"porcentaje": 15.00
}
],
"ofertas": [
{
"codigo": "21600467320190001497_OFERTA_1",
"promocion": "21600467320190001497_OFERTA_1",
"codigoPromocionCliente": "4674",
"importe": 0.44
},
{
"codigo": "21600467320190001497_OFERTA_2",
"promocion": "21600467320190001497_OFERTA_2",
"codigoPromocionCliente": "4674",
"importe": 25.00
},
{
"codigo": "21600467320190001497_OFERTA_3",
"promocion": "21600467320190001497_OFERTA_3",
"codigoPromocionCliente": "4674",
"porcentaje": 25.00
}
],
"lineasPedido": 4,
"fechaEntrega": "17/07/2019",
"idFranja": "4933",
"horaInicioFranja": "11:00",
"horaFinFranja": "12:00",
"esEmpleado": 0,
"descuentoEmpleado": 0,
"sustituciones": 1,
"recogeOtro": 0,
"quienRecoge": "",
"observaciones": "Observaciones pedido",
"gastoEntregaOManipulacion": 7.50,
"gastoEntregaOManipulacionSinPromocion": 7.50,
"descuentoInmediatoPortes": 0.00,
"descuentoDiferidoPortes": 0.00,
"descuentoInmediatoTotal": 0.00,
"descuentoDiferidoTotal": 0,
"totalProductosConPromocionesNoCruzadas": 1.74,
"totalProductosConPromocionesConjunto": 1.74,
"totalProductos": 1.74,
"descuentoProductoInmediatoCruzado": 0.00,
"descuentoProductoDiferidoCruzado": 0.00,
"subtotal": 9.24,
"total": 9.24,
"importeNeto": 9.24,
"descuentoInmediatoImporteNeto": 0,
"descuentoDiferidoImporteNeto": 0,
"descuentoInmediatoProductos": 0.00,
"descuentoDiferidoProductos": 0.00,
"descuentoProductosInmediatoNoCruzado": 0.00,
"descuentoProductosDiferidoNoCruzado": 0.00,
"entregaDomicilio": 1,
"origen": "shop-ws"
},
"productos": [
{
"codigo": "93",
"descripcionLarga": "Calabacín unidad (350gr aprox)",
"tipo": 3,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso por unidades",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.37,
"precioFinalConPromociones": 0.37,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "79",
"descripcionLarga": "<b>Limones</b> unidad (165gr aprox)",
"tipo": 2,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"conversionCantidad": 6,
"conversionUnidadMedida": "ud.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "a rodajas",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.28,
"precioFinalConPromociones": 0.28,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "96",
"descripcionLarga": "Naranja unidad (295gr aprox)",
"tipo": 2,
"cantidad": 0.15,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "bien finito",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.09,
"precioFinalConPromociones": 0.09,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "144794",
"descripcionLarga": "ACTIVIA yogur topper fibras natural edulcorado 186 grs",
"tipo": 1,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 1000.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [
{
"codigo": "CUPON_1",
"promocion": "CUPON_1",
"porcentaje": 10.00
}
],
"ofertas": [],
"nombreTipoProducto": "Estándard",
"formato": "VASOS",
"frecuencia": "",
"precioFinal": 1.00,
"precioFinalConPromociones": 1.00,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
}
],
"datosPago": {
"formaPago": 6,
"otrosDatosPago": [
{
"name": "codigoAutorizacion",
"value": "SIMULADO"
},
{
"name": "proveedorPago",
"value": "no definido"
},
{
"name": "tarjetaPropia",
"value": 0
}
]
},
"versionJ": "2.6"
}
Ejemplo alta pedido con PSD2
{
"datosUsuario": {
"codigoUsuario": "usuario.prueba@aktios.com",
"email": "usuario.prueba@aktios.com",
"nombre": "Usuario",
"apellido1": "Prueba",
"apellido2": "Aktios",
"sexo": "H",
"tipoDocumento": "NIF",
"numeroDocumento": "12341234G",
"fechaNacimiento": "20/11/2019",
"nacionalidad": "ESPAÑA",
"telefono1": "633322211",
"telefono2": "9111111111",
"deseaSms": 1,
"deseaCorreo": 1,
"deseaFactura": 1,
"tipoUsuario": "P",
"socio": 1,
"codigoCliente": null,
"admiteConectarEnNombreDe": 1
},
"direccionUsuario": {
"tipoVia": "",
"nombreVia": "VIRGEN Mayor",
"anexoVia": "5",
"numero": "21",
"escalera": "Izquierda",
"piso": "Bajo",
"letra": "B",
"cp": "08006",
"localidad": "Barcelona",
"provincia": "Barcelona",
"codigoPais": 724
},
"direccionEntrega": {
"tipoVia": "Calle",
"nombreVia": "ZONA 14972",
"anexoVia": "",
"numero": "S/N",
"escalera": "",
"piso": "",
"letra": "",
"cp": "20301",
"localidad": "Irun",
"provincia": "Gipuzkoa",
"codigoPais": 724
},
"direccionFactura": null,
"datosPedido": {
"codigo": 1947,
"codigoZona": 14972,
"codigoTiendaFisica": "1556",
"tipoEntrega": "D",
"fecha": "16/07/2019",
"hora": "13:05",
"idioma": "es",
"divisa": "EUR",
"ivaPicking": 4.00,
"ivaTransporte": 4.00,
"importe": 0,
"cupones": [
{
"codigo": "21600467320190001497_CUPON_1",
"promocion": "21600467320190001497_CUPON_1",
"codigoPromocionCliente": "4674",
"importe": 15.00
},
{
"codigo": "21600467320190001497_CUPON_2",
"promocion": "21600467320190001497_CUPON_2",
"codigoPromocionCliente": "4674",
"importe": 0.26
},
{
"codigo": "21600467320190001497_CUPON_3",
"promocion": "21600467320190001497_CUPON_3",
"codigoPromocionCliente": "4674",
"porcentaje": 15.00
}
],
"ofertas": [
{
"codigo": "21600467320190001497_OFERTA_1",
"promocion": "21600467320190001497_OFERTA_1",
"codigoPromocionCliente": "4674",
"importe": 0.44
},
{
"codigo": "21600467320190001497_OFERTA_2",
"promocion": "21600467320190001497_OFERTA_2",
"codigoPromocionCliente": "4674",
"importe": 25.00
},
{
"codigo": "21600467320190001497_OFERTA_3",
"promocion": "21600467320190001497_OFERTA_3",
"codigoPromocionCliente": "4674",
"porcentaje": 25.00
}
],
"lineasPedido": 4,
"fechaEntrega": "17/07/2019",
"idFranja": "4933",
"horaInicioFranja": "11:00",
"horaFinFranja": "12:00",
"esEmpleado": 0,
"descuentoEmpleado": 0,
"sustituciones": 1,
"recogeOtro": 0,
"quienRecoge": "",
"observaciones": "Observaciones pedido",
"gastoEntregaOManipulacion": 7.50,
"gastoEntregaOManipulacionSinPromocion": 7.50,
"descuentoInmediatoPortes": 0.00,
"descuentoDiferidoPortes": 0.00,
"descuentoInmediatoTotal": 0.00,
"descuentoDiferidoTotal": 0,
"totalProductosConPromocionesNoCruzadas": 1.74,
"totalProductosConPromocionesConjunto": 1.74,
"totalProductos": 1.74,
"descuentoProductoInmediatoCruzado": 0.00,
"descuentoProductoDiferidoCruzado": 0.00,
"subtotal": 9.24,
"total": 9.24,
"importeNeto": 9.24,
"descuentoInmediatoImporteNeto": 0,
"descuentoDiferidoImporteNeto": 0,
"descuentoInmediatoProductos": 0.00,
"descuentoDiferidoProductos": 0.00,
"descuentoProductosInmediatoNoCruzado": 0.00,
"descuentoProductosDiferidoNoCruzado": 0.00,
"entregaDomicilio": 1,
"origen": "shop-ws"
},
"productos": [
{
"codigo": "93",
"descripcionLarga": "Calabacín unidad (350gr aprox)",
"tipo": 3,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"tipoPreparacion": [
{ // ejemplo de tipo preparacion
"codigo": "afiletes001",
"descripcion": "a filetes",
}
],
"observaciones": "",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso por unidades",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.37,
"precioFinalConPromociones": 0.37,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "79",
"descripcionLarga": "<b>Limones</b> unidad (165gr aprox)",
"tipo": 2,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "a rodajas",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.28,
"precioFinalConPromociones": 0.28,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "96",
"descripcionLarga": "Naranja unidad (295gr aprox)",
"tipo": 2,
"cantidad": 0.15,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 400.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "bien finito",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [],
"ofertas": [],
"nombreTipoProducto": "A peso",
"formato": "CAJAS",
"frecuencia": "",
"precioFinal": 0.09,
"precioFinalConPromociones": 0.09,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
},
{
"codigo": "144794",
"descripcionLarga": "ACTIVIA yogur topper fibras natural edulcorado 186 grs",
"tipo": 1,
"cantidad": 1.00,
"unidadMedida": "u.",
"unidadMedidaPrecioUnitario": "Kg.",
"iva": 1000.00,
"tipoIva": 0,
"grupoPicking": 1,
"ordenPicking1": 1,
"ordenPicking2": 2,
"ordenPicking3": 3,
"recurrente": 0,
"observaciones": "",
"precioUnitario": 1.55000,
"precioUnitarioOferta": 0,
"cupones": [
{
"codigo": "CUPON_1",
"promocion": "CUPON_1",
"porcentaje": 10.00
}
],
"ofertas": [],
"nombreTipoProducto": "Estándard",
"formato": "VASOS",
"frecuencia": "",
"precioFinal": 1.00,
"precioFinalConPromociones": 1.00,
"diferidoAcumulado": 0.00,
"descuentoInmediato": 0.00
}
],
"datosPago": {
"formaPago": 6,
"otrosDatosPago": [
{
"name": "codigoAutorizacion",
"value": "SIMULADO"
},
{
"name": "proveedorPago",
"value": "no definido"
},
{
"name": "tarjetaPropia",
"value": 0
},
{
"name": "dsMerchantIdentifier",
"value": "d20489fe323abcf664cfab3fbfa46a97fdd7dcb8"
},
{
"name": "dsMerchantCofTxnid",
"value": "2011101242430"
}
]
},
"versionJ": "2.6"
}
Gestión de versiones
| Versión | Cambios |
|---|---|
| 2.6.4 | Agregado “importeIncrementado” en datos de pedido. Agregado “tipoPreparacion” en tipo de producto |