Tipos de datos

El API utiliza siguientes tipos de datos:

Tipo Descripción
string Cadena de texto.
uuid Una cadena de texto que representa un identificador UUID.
integer Un numero entero entre -2.147.483.648 y 2.147.483.647.
Para los valores hash utilizamos un 32bit unsigned int, entre 0 y 4.294.967.295.
decimal Un numero decimal.
datetime Una fecha y hora en formato yyyy-mm-ddThh:mm:ss (según el ISO8601).
Para fechas sin hora indicamos siempre 00:00:00. No incluye la zona horaria.
bool Un valor lógico: true o false.
X Un valor de tipo X indicado. El X esta definido en esta documentación.
[X, ] Una lista/array del tipo X indicado.

Estructuras de datos

El api implementa las siguientes estructuras de datos:

ActualizacionCliente

Representa un cliente para actualizar o dar de alta en winfra. 

{
    "cif": "G98798798",
    "clases_vehiculo": "",
    "dias_cerrado": "L",
    "dias_servicio": "MXJVSD",
    "direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Mayor 10",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "direccion_fiscal": null,
    "direccion_reparto": {
        "codigo_postal": "46680",
        "direccion": "Calle Cervantes 5",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "reparto"
    },
    "email_facturacion": "[email protected]",
    "exento_iva": false,
    "exento_sig": false,
    "horario_preferente": "",
    "id": "",
    "nombre_comercial": "Bar Altamira",
    "numero_ayudantes": 0,
    "paletizado": "no",
    "persona_contacto": "Victor",
    "prioridad_reparto": "normal",
    "razon_social": "Fundacion Pepe Lopez",
    "recargo": false,
    "telefono_contacto": "+34937458600",
    "tiempo_minimo_estancia": 0,
    "tipo_reparto": "i"
}
Campo Tipo Descripción
id uuid identificador del cliente. Solo hay que indicarlo si es una modificación.
nombre_comercial string nombre del cliente. Este campo es obligatorio en el alta.
cif string código de identificación fiscal. Este campo es obligatorio en el alta.
razon_social string razon social del documento. Este campo es obligatorio en el alta.
direccion Direccion dirección genérica del cliente. Este campo es obligatorio en el alta.
direccion_fiscal Direccion dirección fiscal del cliente. Si es la misma que la genérica no hace falta indicarla.
direccion_reparto Direccion dirección de reparto del cliente. Si es la misma que la genérica no hace falta indicarla.
email_facturacion string mail del cliente para recibir las facturas. Este campo es opcional.
persona_contacto string nombre de la persona de contacto del cliente. Este campo es opcional.
telefono_contacto string teléfono de la persona de contacto. Este campo es opcional.
recargo bool true si el cliente tiene recargo. Este campo es opcional.
exento_sig bool true si el cliente es exento de SIG (ecotasa). Este campo es opcional.
exento_iva bool true si el cliente es exento de IVA. Este campo es opcional.
horario_preferente string descripción del horario y servicio al cliente. Este campo es opcional.
dias_cerrado string días que está cerrado el cliente. L,M,X,J,V,S,D Este campo es opcional.
dias_servicio string días que está operativo el cliente. L,M,X,J,V,S,D Este campo es opcional.
tipo_reparto string tipo del reparto: i(Indiferente), m(Mañana), t(Tarde), n(Noche). Este campo es opcional.
clases_vehiculo string la clasificación de vehículo requerida para el reparto. Este campo es opcional.
tiempo_minimo_estancia integer minutos de tiempo requerido para la parada en el reparto (por defecto 0). Este campo es opcional.
numero_ayudantes integer número de ayudantes a repartidor para la carga y descarga (por defecto 0). Este campo es opcional.
prioridad_reparto string prioridad del reparto: alta, normal, baja. Este campo es opcional.
paletizado string tipo de paletización del cliente: no, aviso, automatico. Este campo es opcional.

Adjunto

Representa el fichero adjunto como una imagen del artículo. 

{
    "datos": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8... ...AAAAAElFTkSuQmCC",
    "datos_vista_previa": "",
    "formato": "jpg",
    "nombre": "Imagen_1045",
    "por_defecto": true
}
Campo Tipo Descripción
nombre string nombre del adjunto
formato string el formato del fichero adjunto como png, jpg etc.
datos string bytes del fichero como base64
datos_vista_previa string bytes de la vista previa del fichero o vacío si no esta disponible. Codificado en base64.
por_defecto bool true si es la imagen por defecto

Apunte

Representa un apunte contable 

{
    "debe": 1210.0,
    "descripcion": "F20001",
    "haber": 0.0,
    "interlocutor": {
        "codigo": "10001",
        "hash": 0,
        "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
        "nombre": "GRUPO HOSTELEROS S.L.",
        "tipo": "cliente"
    },
    "numero": 1,
    "subcuenta": "4300000321"
}
Campo Tipo Descripción
numero integer número de apunte
descripcion string descripción del apunte
subcuenta string subcuenta del apunte
debe decimal importe al debe
haber decimal importe al haber
interlocutor InterlocutorComercialResumen interlocutor comercial asociado con el apunto o None

Articulo

Representa un artículo para la venta. El artículo tiene uno o varios formatos. Opcionalmente puede tener ficheros adjuntos como por ejemplo imagen de artículo. 

{
    "adjuntos": [
        {
            "datos": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8... ...AAAAAElFTkSuQmCC",
            "datos_vista_previa": "",
            "formato": "jpg",
            "nombre": "Imagen_1045",
            "por_defecto": true
        }
    ],
    "capacidad": "33cl",
    "codigo": "1045",
    "descripcion": "Cerveza San Miguel 1/3, cerveza rubia de sabor fresco y de ligero amargor.",
    "dimension1_codigo": "",
    "dimension1_descripcion": "",
    "dimension2_codigo": "",
    "dimension2_descripcion": "",
    "dimension3_codigo": "",
    "dimension3_descripcion": "",
    "dimension4_codigo": "",
    "dimension4_descripcion": "",
    "fabricante_codigo": "24",
    "fabricante_descripcion": "San Miguel",
    "formatos": [
        {
            "baja": false,
            "cajas_fila": 0,
            "cajas_palet": 50,
            "codigo": "1045-24",
            "control_stock": true,
            "descripcion": "San Miguel 1/3 24x",
            "envase_id": "36c06667-0069-4cca-9455-0847daed37eb",
            "equivalencia": 24.0,
            "es_peso": false,
            "es_peso_unitario": false,
            "etiquetas": [
                {
                    "descripcion": "cerveza nacional",
                    "nombre": "nacional"
                },
                {
                    "descripcion": "",
                    "nombre": "tercio"
                }
            ],
            "id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
            "litros": 0.33,
            "nivel_refrigeracion": "SinFrio",
            "nombre": "San Miguel 1/3 Caja 24 botellas",
            "peso": 9.6,
            "peso_neto": 7.2,
            "peso_por_defecto": 0.0,
            "precio_unidad_kg": false,
            "tasas": [
                {
                    "tipo": "SIG",
                    "valor": 0.05
                }
            ],
            "tipo": "caja",
            "tipo_formato": "venta",
            "unidad_medida": "Caja",
            "unidades_fraccion": 24,
            "volumen": 0.0072
        },
        {
            "baja": false,
            "codigo": "1045-1",
            "control_stock": true,
            "descripcion": "San Miguel 1/3",
            "envase_id": "",
            "equivalencia": 1.0,
            "etiquetas": [
                "nacional",
                "tercio"
            ],
            "id": "3b3ab89d-427f-7563-9863-87644d89e8bd",
            "litros": 0.33,
            "nivel_refrigeracion": "SinFrio",
            "nombre": "San Miguel 1/3 botella",
            "peso": 0.4,
            "peso_neto": 0.3,
            "peso_por_defecto": 0.0,
            "tasas": [
                {
                    "tipo": "SIG",
                    "valor": 1.2
                }
            ],
            "tipo": "unidad",
            "tipo_formato": "venta",
            "unidad_medida": "Botella",
            "unidades_fraccion": 4,
            "volumen": 0.0003
        }
    ],
    "grados_alcohol": 4.5,
    "hash": 32145,
    "id": "8fd593d0-f7d8-44c9-bfb9-026d823b3d95",
    "impuestos": [
        {
            "base": 100.0,
            "descripcion": "IVA general",
            "grupo": "general",
            "iva": 21.0,
            "recargo": 5.2
        }
    ],
    "marca": "",
    "nombre": "San Miguel 1/3",
    "organizacion_venta": "Bebidas",
    "subcuenta_compras": "6000000001",
    "subcuenta_ventas": "7000000001",
    "subtipo": "",
    "subtipo_descripcion": "",
    "tipo": "producto",
    "tipo_descripcion": "Producto"
}
Campo Tipo Descripción
id uuid identificador del artículo
tipo string tipo de articulo: producto, envase, plv, cargo
codigo string código de articulo
nombre string nombre de artículo
descripcion string descripción larga de artículo
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que el artículo cambia.
tipo_descripcion string descripción de tipo de artículo
dimension1_codigo string
dimension1_descripcion string
dimension2_codigo string
dimension2_descripcion string
dimension3_codigo string
dimension3_descripcion string
dimension4_codigo string
dimension4_descripcion string
fabricante_codigo string código del fabricante
fabricante_descripcion string descripción del fabricante del artículo
marca string la marca del articulo
organizacion_venta string código de organización de la venta
subtipo string código de subtipo
subtipo_descripcion string descripción de subtipo
formatos [Formato, ] lista de formatos de articulo
adjuntos [Adjunto, ] lista de ficheros adjuntos al articulo
impuestos [Impuesto, ] lista de impuestos asociados con el artículo
capacidad string una descripción informativa de capacidad, por ejemplo 75cl
grados_alcohol decimal graduación alcohólica de etanol expresada en porcentajes
subcuenta_compras string subcuenta para compras nacionales
subcuenta_ventas string subcuenta para ventas nacionales

ArticuloFicha

Representa información sobre la ficha de un artículo. 

{
    "es_contrato": false,
    "es_intermediacion": false,
    "es_rappel": false,
    "ficha_descuentos": [
        {
            "desde_valor": 0.0,
            "dto_text": "10.00 %",
            "tipo_calculo": "porcentaje",
            "valor_dto": 10.0
        }
    ],
    "formato_id": "3b3ab89d-427f-7563-9863-87644d89e8bd",
    "ultima_venta_cantidad_entrega": 5.0,
    "ultima_venta_cantidad_promocion": 0.0,
    "ultima_venta_dto_euroscaja": 0.0,
    "ultima_venta_dto_porcentaje": 10.0,
    "ultima_venta_fecha": "2022-11-10T00:00:00",
    "ultima_venta_precio_aplicado": 0.0
}
Campo Tipo Descripción
formato_id uuid identificador del formato
ultima_venta_cantidad_entrega decimal cantidad de entrega de la última venta
ultima_venta_cantidad_promocion decimal cantidad promoción de la última venta
ultima_venta_precio_aplicado decimal precio aplicado en la última venta
ultima_venta_dto_porcentaje decimal descuento en porcentaje de la última venta
ultima_venta_dto_euroscaja decimal descuento en euros de la última venta
ultima_venta_fecha datetime fecha y hora de la última venta
ficha_descuentos [ArticuloFichaDescuento, ] descuentos asociados a la ficha
es_intermediacion bool True si el artículo es de intermediación
es_contrato bool True si el cliente tiene un contrato para el artículo
es_rappel bool True si el cliente tiene un rappel para el artículo

ArticuloFichaDescuento

Representa información sobre un descuento de una ficha de artículo. 

{
    "desde_valor": 0.0,
    "dto_text": "10.00 %",
    "tipo_calculo": "porcentaje",
    "valor_dto": 10.0
}
Campo Tipo Descripción
tipo_calculo string tipo de cálculo del descuento: regalo, euroscaja, euroslitro, porcentaje, precio
desde_valor decimal valor desde el que se aplica la condición
valor_dto decimal valor que se aplica al llegar al desde_valor
dto_text string valor del descuento en formato texto para poder mostrar por ejemplo 10,47 €/caja

ArticuloGrupo

Representa un grupo de artículos. 

{
    "adjuntos": [
        {
            "datos": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8... ...AAAAAElFTkSuQmCC",
            "datos_vista_previa": "",
            "formato": "jpg",
            "nombre": "Imagen_1045",
            "por_defecto": true
        }
    ],
    "codigo": "1",
    "destacado": false,
    "id": "0a2c1075-569b-11eb-9fa0-54e1ade9de7d",
    "nombre": "Cervezas",
    "tipo": "GAMA"
}
Campo Tipo Descripción
id uuid identificador del grupo
codigo string código de grupo
nombre string nombre de grupo
tipo string tipo de grupo. Varios grupos pueden ser del mismo tipo, por ejemplo grupos 'limón' y 'naranja' son de tipo 'sabor'. El campo puede estar vacío.
adjuntos [Adjunto, ] lista de ficheros adjuntos al grupo
destacado bool true si es un grupo de los artículos destacados, por ejemplo promoción o oferta

ArticuloLote

Representa un lote de artículos/lote de promoción/escandallo. Opcionalmente puede obtener imagenes del lote. 

{
    "adjuntos": [
        {
            "datos": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8... ...AAAAAElFTkSuQmCC",
            "datos_vista_previa": "",
            "formato": "jpg",
            "nombre": "Imagen_1045",
            "por_defecto": true
        }
    ],
    "codigo": "1",
    "descripcion": "RADLER/HNK/DESP/AGUILA",
    "fecha_desde": "2020-06-01T00:00:00",
    "fecha_hasta": "2020-06-07T00:00:00",
    "fracciones_cargo": 0.0,
    "fracciones_regalo": 2.0,
    "lineas": [
        {
            "cantidad_minima": 2.0,
            "descuento": 5.0,
            "es_regalo": true,
            "formato_codigo": "LI106",
            "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
            "formato_nombre": "BARRIL CERVEZA 30 L."
        }
    ],
    "unidades_cargo": 2.0,
    "unidades_regalo": 0.0
}
Campo Tipo Descripción
codigo string código del lote
descripcion string descripción del lote
fecha_desde datetime fecha de inicio de validez del lote
fecha_hasta datetime fecha de fin de validez del lote
unidades_cargo decimal total cajas de cargo (indicamos o total cajas o total unidades)
fracciones_cargo decimal total unidades de cargo (indicamos o total cajas o total unidades)
unidades_regalo decimal total cajas de regalo (indicamos o total cajas o total unidades)
fracciones_regalo decimal total unidades de regalo (indicamos o total cajas o total unidades)
lineas [ArticuloLoteLinea, ] lineas de artículos incluidos en el lote
adjuntos [Adjunto, ] lista de imagenes del lote

ArticuloLoteLinea

Representa la linea del articulo. 

{
    "cantidad_minima": 2.0,
    "descuento": 5.0,
    "es_regalo": true,
    "formato_codigo": "LI106",
    "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
    "formato_nombre": "BARRIL CERVEZA 30 L."
}
Campo Tipo Descripción
formato_id uuid identificador del formato
formato_codigo string código del formato
formato_nombre string nombre del formato
cantidad_minima decimal cantidad mínima del articulo
es_regalo bool indica si el articulo es regalo
descuento decimal descuento en euros aplicado en la linea

ArticuloPublicacion

Representa la linea del articulo de una publicacion. 

{
    "formato_codigo": "LI106",
    "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
    "formato_nombre": "BARRIL CERVEZA 30 L.",
    "precio_base": 20.5,
    "precio_recomendado": 25.0
}
Campo Tipo Descripción
formato_id uuid identificador del formato
formato_codigo string código del formato
formato_nombre string nombre del formato
precio_base decimal precio base sobre el que se calcula el margen
precio_recomendado decimal precio de venta recomendado

ArticuloResumen

Representa una versión resumida de artículo para mostrar como resultado de la búsqueda etc. 

{
    "codigo": "1045",
    "hash": 32145,
    "id": "8fd593d0-f7d8-44c9-bfb9-026d823b3d95",
    "nombre": "San Miguel 1/3",
    "tipo": "producto"
}
Campo Tipo Descripción
id string identificador del articulo
codigo string código de articulo
nombre string nombre de artículo
tipo string tipo de articulo véase Articulo
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que el artículo cambia. Este valor solo esta calculado en la llamada a /articulos/

Asiento

Representa un asiento contable 

{
    "apuntes": [
        {
            "debe": 1210.0,
            "descripcion": "F20001",
            "haber": 0.0,
            "interlocutor": {
                "codigo": "10001",
                "hash": 0,
                "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
                "nombre": "GRUPO HOSTELEROS S.L.",
                "tipo": "cliente"
            },
            "numero": 1,
            "subcuenta": "4300000321"
        },
        {
            "debe": 0.0,
            "descripcion": "N/FRA F20001",
            "haber": 1210.0,
            "interlocutor": null,
            "numero": 2,
            "subcuenta": "6000000001"
        }
    ],
    "descripcion": "ASIENTO FACTURA",
    "ejercicio": 2020,
    "fecha": "2020-05-30T00:00:00",
    "numero": 100,
    "origen": "VENTA FACTURAS",
    "periodo": "MAR",
    "registros": [
        {
            "desgloses": [
                {
                    "base": 1210.0,
                    "cuota_iva": 254.1,
                    "cuota_recargo": 62.92,
                    "grupo": "general",
                    "iva": 21.0,
                    "recargo": 5.2
                }
            ],
            "factura": "F20001",
            "fecha": "2020-05-30T00:00:00",
            "fecha_expedicion": "2020-05-30T00:00:00",
            "idfiscal": {
                "codigo_documento": "B98798757",
                "forma_juridica": "B",
                "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
                "nombre": "GRUPO HOSTELEROS S.L.",
                "tipo_documento": "CIF"
            },
            "numero_emitido": 20001,
            "numero_recepcion": 0,
            "serie_emitida": "F",
            "tipo": "Expedidas",
            "tipo_iva": "Repercutido"
        }
    ]
}
Campo Tipo Descripción
numero integer número de asiento
descripcion string descripción del asiento
fecha datetime fecha del asiento
ejercicio integer ejercicio contable
periodo string periodo contable
origen string origen del asiento
apuntes [Apunte, ] lista de apuntes del asiento
registros [RegistroIva, ] lista de registros de iva asociados al asiento

CargaMovil

Representa una carga móvil disponible para descargar. 

{
    "carga_id": "10da09fd-cff0-11ea-ab4c-54e1ade9de7d",
    "version": "20200727120046"
}
Campo Tipo Descripción
carga_id uuid identificador de la carga disponible. Utiliza el identificador para descargar el fichero de la carga.
version string numero de la versión de carga. Utiliza la versión para comprobar si existe una nueva carga preparada antes de descargarla.

CentroCoste

Representa un centro de coste. 

{
    "clave_dimension": "P",
    "codigo": "CERV",
    "descripcion": "CERVEZA",
    "id": "94a3365a-2cd2-11ec-9784-54e1ade9de7d",
    "nivel": 1,
    "tipo_dimension": "Organizacion"
}
Campo Tipo Descripción
id uuid identificador del centro
codigo string código del centro
descripcion string descripción del centro
clave_dimension string clave de la dimensión
tipo_dimension string tipo de dimensión, uno de: almacen, organizacion, personal_tipo, tipo_distribucion, contabilidad
nivel integer nivel del centro

Compra

Representa documento de compra. 

{
    "almacen_codigo": "001",
    "almacen_nombre": "General",
    "canal": "",
    "delegacion": "X",
    "dto_pronto_pago": 0.0,
    "estado": "Recepcionado",
    "factura_fecha": "2020-11-15T00:00:00",
    "factura_numero": 2346,
    "factura_serie": "FC",
    "fecha_documento": "2020-10-28T00:00:00",
    "fecha_recepcion": "2020-10-28T00:00:00",
    "forma_pago": "1",
    "forma_pago_descripcion": "CONTADO",
    "hash": 456724,
    "id": "47564104-b242-11ea-97da-00155d0a2014",
    "lineas": [
        {
            "cantidad_entrega": 1.0,
            "cantidad_entrega_palets": 1.0,
            "cantidad_pedido": 1.0,
            "cantidad_valoracion": 1.0,
            "envase_codigo": "",
            "envase_id": "",
            "envase_nombre": "",
            "euros_descuento": 0.0,
            "euros_descuento_cesion": 0.0,
            "formato_codigo": "LI106",
            "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
            "formato_nombre": "BARRIL CERVEZA 30 L.",
            "importe_sig": 0.0,
            "impuestoenvase": 0.0,
            "impuestoliquido": 3.0,
            "orden": 0,
            "peso_bruto": 36.5,
            "peso_neto": 22.3,
            "precio": 30.0,
            "precio_envase": 0.0,
            "precio_neto": 21.0,
            "total": 30.0,
            "totalconimpuestos": 33.0,
            "totalenvase": 0.0,
            "totalliquido": 30.0,
            "valor_sig": 0.0,
            "valorimpuesto": "10.00",
            "valorimpuestoenvase": ""
        }
    ],
    "numero": 130,
    "proveedor": {
        "codigo": "10001",
        "hash": 0,
        "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
        "nombre": "BODEGAS ARRIATE S.L.",
        "tipo": "proveedor"
    },
    "serie": "CC",
    "tipo_documento": "Albaran",
    "total": 30.0,
    "total_con_impuestos": 33.0
}
Campo Tipo Descripción
almacen_codigo string código del almacen
almacen_nombre string nombre de almacen
proveedor InterlocutorComercialResumen proveedor de la compra
dto_pronto_pago decimal descuento de pronto pago aplicado (en porcentajes)
forma_pago string código de la forma de pago
forma_pago_descripcion string descripción de la forma de pago
lineas [CompraLinea, ] líneas de compra
delegacion string clave de dimensión del centro de costes del almacén
factura_serie string serie de la factura si el documento esta facturado
factura_numero integer numero de la factura si el documento esta facturado
factura_fecha datetime fecha de la factura si el documento esta facturado

CompraLinea

Representa una linea de compra 

{
    "cantidad_entrega": 1.0,
    "cantidad_entrega_palets": 1.0,
    "cantidad_pedido": 1.0,
    "cantidad_valoracion": 1.0,
    "envase_codigo": "",
    "envase_id": "",
    "envase_nombre": "",
    "euros_descuento": 0.0,
    "euros_descuento_cesion": 0.0,
    "formato_codigo": "LI106",
    "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
    "formato_nombre": "BARRIL CERVEZA 30 L.",
    "importe_sig": 0.0,
    "impuestoenvase": 0.0,
    "impuestoliquido": 3.0,
    "orden": 0,
    "peso_bruto": 36.5,
    "peso_neto": 22.3,
    "precio": 30.0,
    "precio_envase": 0.0,
    "precio_neto": 21.0,
    "total": 30.0,
    "totalconimpuestos": 33.0,
    "totalenvase": 0.0,
    "totalliquido": 30.0,
    "valor_sig": 0.0,
    "valorimpuesto": "10.00",
    "valorimpuestoenvase": ""
}
Campo Tipo Descripción
cantidad_entrega decimal cantidad de mercancía recepcionada
cantidad_pedido decimal cantidad de mercancía pedida (cantidad original del pedido)
cantidad_valoracion decimal cantidad de mercancía para valorar la línea. Normalmente coincide con cantidad entregada, pero indica peso en los artículos de peso
envase_codigo string código de envase
envase_id uuid id del formato del envase asociado o vacío si el envase no es aplicable
envase_nombre string nombre de envase
euros_descuento decimal total descuento aplicado sobre la linea que no son de tipo cesion
euros_descuento_cesion decimal total descuento aplicado sobre la linea de tipo cesion
formato_codigo string código de formato
formato_id uuid id del formato
formato_nombre string nombre de formato
peso_bruto decimal total peso de la línea
peso_neto decimal total peso neto de la línea
importe_sig decimal importe total del SIG (punto verde)
impuestoenvase decimal total cuotas de IVA aplicadas sobre envase asociado
impuestoliquido decimal total cuotas de IVA aplicadas sobre liquido
orden integer orden de las lineas
precio_envase decimal precio de envase asociado
precio decimal precio aplicado sobre la línea
precio_neto decimal precio neto de la línea
totalconimpuestos decimal total de la linea incluyendo los impuestos
totalenvase decimal total del envase asociado
totalliquido decimal total del liquido
total decimal total de la linea
valor_sig decimal tasa de SIG (punto verde)
valorimpuestoenvase string una representación de porcentaje de IVA aplicado a envase, ej.: 10
valorimpuesto string una representación de porcentaje de IIVA aplicado a liquido, vacío si hay varios impuestos aplicados
cantidad_entrega_palets decimal cantidad de mercancía recepcionada indicada en palets

CompraResumen

Representa un resumen del documento de compra. 

{
    "estado": "Recepcionado",
    "fecha_documento": "2020-10-28T00:00:00",
    "fecha_recepcion": "2020-10-28T00:00:00",
    "hash": 456724,
    "id": "47564104-b242-11ea-97da-00155d0a2014",
    "numero": 130,
    "serie": "CC",
    "tipo_documento": "Albaran",
    "total": 30.0,
    "total_con_impuestos": 33.0
}
Campo Tipo Descripción
id uuid identificador de la compra
serie string serie de documento de compra
numero integer numero de documento de compra
tipo_documento string tipo del documento: pedido, albaran, albaran consigna
estado string estado de documento: 'generado', 'solicitado al proveedor', 'asignado por el proveedor', 'asignada fecha de carga', 'recepcionado', 'facturado', 'anulado', 'rechazado'
fecha_documento datetime fecha de creación/valoración de la compra
fecha_recepcion datetime fecha de recepción de la mercancía
total decimal total de la compra antes de aplicar IVA
total_con_impuestos decimal total de la compra con impuestos
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que la compra cambia.

Contacto

Representa una persona de contacto con su telefono, email etc. 

{
    "cargo": "Director",
    "email": "[email protected]",
    "fax": "",
    "fijo": "+34123123123",
    "movil": "+34321321321",
    "nombre": "Pepe Lopez"
}
Campo Tipo Descripción
nombre string nombre de la persona de contacto
cargo string cargo de la persona de contacto
fijo string numero de teléfono fijo
movil string numero de teléfono móvil
fax string numero de fax
email string dirección de correo electrónico

Descuento

Representa un descuento aplicado a un formato en el periodo indicado. Tipo del descuento indica que campo tiene valor aplicable. 

{
    "cargo": 0.0,
    "euros": 0.0,
    "fecha_desde": "2020-08-01T00:00:00",
    "fecha_hasta": "2020-08-31T00:00:00",
    "formato_codigo": "1045-24",
    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "minimo": 0.0,
    "porcentaje": 20.0,
    "precio": 0.0,
    "regalo": 0.0,
    "tipo": "porcentaje"
}
Campo Tipo Descripción
formato_id uuid identificador del formato del artículo
formato_codigo string código del formato del artículo
fecha_desde datetime fecha desde la que aplicamos el descuento
fecha_hasta datetime fecha hasta la que aplicamos el descuento (inclusivo)
tipo string tipo de la condicion: porcentaje, euros, precio, regalo
minimo string cantidad minima desde la que hay que aplicar el descuento
porcentaje decimal un porcentaje de descuento
euros decimal cantidad de euros de descuento por formato
precio decimal un precio especial aplicable en lugar de la tarifa
cargo decimal cantidad de cargo para aplicar el regalo. 2+1 (paga 2 llevate 3) es cargo=2, regalo=1
regalo decimal cantidad regalada

DesgloseIva

Representa un detalle del registro de I.V.A. 

{
    "base": 1210.0,
    "cuota_iva": 254.1,
    "cuota_recargo": 62.92,
    "grupo": "general",
    "iva": 21.0,
    "recargo": 5.2
}
Campo Tipo Descripción
grupo string indica el tipo de IVA: general, reducido, super reducido, exento
base decimal base imponible
cuota_iva decimal cuota de I.V.A
cuota_recargo decimal cuota del recargo de equivalencia
iva decimal porcentaje de impuesto
recargo decimal porcentaje de recargo de equivalencia

Deuda

Representa una deuda o efecto 

{
    "carga_en_pda": true,
    "clasificacion_deuda_descripcion": "Corriente",
    "deuda_corriente": true,
    "documento_origen_id": null,
    "estado_registro": "pendiente",
    "fecha_documento": "2023-02-01T00:00:00",
    "fecha_operacion": "2023-02-02T00:00:00",
    "fecha_solicitud": "2023-03-04T00:00:00",
    "fecha_vencimiento": "2023-12-30T00:00:00",
    "forma_pago_codigo": "101",
    "forma_pago_descripcion": "Giro",
    "importe_documento": 200.0,
    "importe_pendiente": 50.0,
    "importe_saldado": 50.0,
    "interlocutor_comercial": {
        "codigo": "10000",
        "hash": 4153754459,
        "id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
        "nombre": "MUSEO DE LA FAUNA SALVAJE",
        "tipo": "cliente"
    },
    "partidas_compensadas": {
        "documento_de_saldo": {
            "fecha_documento": "2023-07-03T00:00:00",
            "fecha_operacion": "2023-07-03T00:00:00",
            "fecha_vencimiento": "2023-07-03T00:00:00",
            "liquidado": false,
            "pendiente": 0.0,
            "referencia": "65348",
            "tesoreria_deuda_id": "900748a2-9725-4222-80bc-f0f2b11lpc20"
        },
        "operaciones": [
            {
                "estado": "Cerrada",
                "fecha": "2023-07-03T00:00:00",
                "importe": 132.89,
                "tesoreria_operacion_id": "900068a2-34r25-4222-80bc-f0f2b11hjc20",
                "tipo": "Cobros"
            }
        ],
        "tesoreria_efectos": [
            {
                "documento": 10987,
                "estado": "En cartera",
                "fecha_documento": "2023-07-03T00:00:00",
                "fecha_vencimiento": "2023-07-03T00:00:00",
                "importe": 0.0,
                "tesoreria_cartera_efecto_id": "900068a2-juh5-4222-80bc-f0f2671fcc20",
                "tipo": "Cobro",
                "tipo_documento": "Cheque"
            }
        ]
    },
    "referencia2": "10",
    "referencia_documento": "A101",
    "registro_id": "c3a1f1a0-41e3-11e6-ab5f-002481a3785c",
    "subcuenta": null,
    "tipo_documento_origen": "Manual",
    "tipo_registro": "deuda",
    "tipo_signo": "cobro"
}
Campo Tipo Descripción
registro_id uuid identificador de la deuda o el efecto
tipo_registro string tipo de registro: deuda, cheque, giro, pagare
tipo_signo string tipo de signo: pago o cobro
estado_registro string estado del documento: pendiente, en cartera, depositado, remesado, generado, emitido, reagrupado
fecha_solicitud datetime fecha en la que se ha solicitado el dato
interlocutor_comercial InterlocutorComercialResumen interlocutor asociado a la deuda
subcuenta Subcuenta subcuenta asociada a la deuda o al efecto
referencia_documento string referencia del documento
referencia2 string numero de proforma de la venta o el numero de factura del proveedor
fecha_documento datetime fecha del documento
fecha_operacion datetime fecha de operación del documento
fecha_vencimiento datetime fecha de vencimiento del documento
clasificacion_deuda_descripcion string descripción de la clasificación de la deuda
carga_en_pda bool true si la deuda se pasa a la pda para cobrar los vendedores
deuda_corriente bool true si la deuda aparece en los listados
forma_pago_codigo string código de la forma de pago
forma_pago_descripcion string descripción de la forma de pago
importe_documento decimal importe del documento
importe_pendiente decimal importe pendiente por pagar o cobrar
importe_saldado decimal importe saldado del documento
tipo_documento_origen string (Venta/Compra/Contabilidad/Manual)
documento_origen_id uuid identificador del documento de origen
partidas_compensadas PartidasCompensadas Deuda cobrada (documento de saldo, tesoreria efectos y operaciones)

Diario

Representa un diario contable 

{
    "asientos": [
        {
            "apuntes": [
                {
                    "debe": 1210.0,
                    "descripcion": "F20001",
                    "haber": 0.0,
                    "interlocutor": {
                        "codigo": "10001",
                        "hash": 0,
                        "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
                        "nombre": "GRUPO HOSTELEROS S.L.",
                        "tipo": "cliente"
                    },
                    "numero": 1,
                    "subcuenta": "4300000321"
                },
                {
                    "debe": 0.0,
                    "descripcion": "N/FRA F20001",
                    "haber": 1210.0,
                    "interlocutor": null,
                    "numero": 2,
                    "subcuenta": "6000000001"
                }
            ],
            "descripcion": "ASIENTO FACTURA",
            "ejercicio": 2020,
            "fecha": "2020-05-30T00:00:00",
            "numero": 100,
            "origen": "VENTA FACTURAS",
            "periodo": "MAR",
            "registros": [
                {
                    "desgloses": [
                        {
                            "base": 1210.0,
                            "cuota_iva": 254.1,
                            "cuota_recargo": 62.92,
                            "grupo": "general",
                            "iva": 21.0,
                            "recargo": 5.2
                        }
                    ],
                    "factura": "F20001",
                    "fecha": "2020-05-30T00:00:00",
                    "fecha_expedicion": "2020-05-30T00:00:00",
                    "idfiscal": {
                        "codigo_documento": "B98798757",
                        "forma_juridica": "B",
                        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
                        "nombre": "GRUPO HOSTELEROS S.L.",
                        "tipo_documento": "CIF"
                    },
                    "numero_emitido": 20001,
                    "numero_recepcion": 0,
                    "serie_emitida": "F",
                    "tipo": "Expedidas",
                    "tipo_iva": "Repercutido"
                }
            ]
        }
    ],
    "peticion_id": "e59161c0-dec8-11ed-ba88-ac21b5e499d8"
}
Campo Tipo Descripción
peticion_id uuid identificador de la petición
asientos [Asiento, ] lista de asientos del diario

Direccion

Representa una dirección de un interlocutor comercial o dirección fiscal. 

{
    "codigo_postal": "46680",
    "direccion": "Calle Museo 34",
    "latitud": 0.0,
    "longitud": 0.0,
    "pais": "ES",
    "poblacion": "Algemes\u00ed",
    "provincia": "Valencia",
    "tipo": "generica"
}
Campo Tipo Descripción
tipo string tipo de la dirección: generica, reparto
direccion string calle y numero
codigo_postal string código postal de la población
poblacion string nombre de la población
provincia string nombre de la provincia
pais string código de país alfa-2 según normativa ISO 3166-1
latitud decimal coordenada de latitud donde se encuentra la dirección
longitud decimal coordenada de longitud donde se encuentra la dirección

Empleado

Representa un empleado. 

{
    "clave_dimension": "repartidor",
    "codigo": "RP005",
    "id": "00301270-6e90-407d-813d-b2d26fc526ac",
    "idfiscal": {
        "codigo_documento": "B98798646",
        "forma_juridica": "B",
        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175emp",
        "nombre": "FRANCISCO MONTES MONTES",
        "tipo_documento": "CIF"
    },
    "nombre": "PACO MONTES",
    "subcuenta": ""
}
Campo Tipo Descripción
id uuid identificador del empleado
codigo string código del empleado
nombre string nombre del empleado
idfiscal IdentificacionFiscalResumen identificacion fiscal del empleado
clave_dimension string clave de la dimensión según el tipo de empleado
subcuenta string numero de subcuenta contable

EstadoDatasetXXL

Representa un conjunto de los datos generados 

{
    "dataset": "interlocutores",
    "error_message": "",
    "estado": "PENDING",
    "fecha_generacion_fin": null,
    "fecha_generacion_inicio": null,
    "numero_registros": 0
}
Campo Tipo Descripción
dataset string Idenficador del conjunto generado
estado string El estado del conjunto: PENDING, OK, ERROR.
error_message string mensaje de error en el caso del estado ERROR.
fecha_generacion_inicio datetime Fecha del inicio de generación del conjunto. Nulo si no se ha generado todavía.
fecha_generacion_fin datetime Fecha del fin de generación del conjunto. Nulo si no se ha generado todavía.
numero_registros integer Numero de registros incluidos en el conjunto. Utiliza este dato para paginación.

EstadoGenerarXXL

Representa el estado de generación de las datos masivos. 

{
    "datasets": [
        {
            "dataset": "interlocutores",
            "error_message": "",
            "estado": "PENDING",
            "fecha_generacion_fin": null,
            "fecha_generacion_inicio": null,
            "numero_registros": 0
        }
    ],
    "error_message": "",
    "estado": "PENDING",
    "fecha_peticion": "2023-05-06T13:27:46",
    "peticion_id": "575c9ac3-4ea7-40f3-8407-fc8b56b7463b"
}
Campo Tipo Descripción
peticion_id uuid identificador de la petición que creado los conjuntos
fecha_peticion datetime Fecha de la petición.
estado string El estado de la petición: PENDING (hay conjuntos PENDING), OK (todos los conjuntos son OK), ERROR (hay algún conjunto en ERROR)
datasets [EstadoDatasetXXL, ] Lista de los datasets incluidos en la petición.

Etiqueta

Representa una etiqueta con su nombre y descripción. 

{
    "descripcion": "cerveza nacional",
    "nombre": "nacional"
}
Campo Tipo Descripción
nombre string nombre de la etiqueta
descripcion string descripccion de la etiqueta

FacturaContable

Representa una factura contable. 

{
    "factura": "1098522450",
    "fecha_factura": "2020-06-01T00:00:00",
    "fecha_registro": "2020-06-01T00:00:00",
    "forma_de_pago": {
        "abreviatura": "ef",
        "codigo": "contado",
        "descripcion": "Efectivo contado",
        "plazos": [],
        "tipo_documento": "Efectivo"
    },
    "numero": 3,
    "serie": "FCR",
    "subcuenta": {
        "baja": false,
        "centro_coste1_codigo": "COMERC",
        "centro_coste1_descripcion": "COMERCIAL",
        "centro_coste2_codigo": "CERV",
        "centro_coste2_descripcion": "CERVEZA",
        "codigo": "4300011010",
        "descripcion": "BAR EL ABREVADERO",
        "interlocutor_comercial": "C021",
        "proyecto_codigo": "CERV",
        "proyecto_descripcion": "CERVEZA",
        "subcuenta_exportacion": "4300311010"
    },
    "tipo": "Recibida",
    "tipo_iva": "Soportado",
    "total_con_impuestos": 19.66,
    "total_sin_impuestos": 16.25
}
Campo Tipo Descripción
serie string serie de la factura contable
numero integer numero de de la factura contable
factura string para las facturas recibidas contiene serie y numero de la factura del proveedor o acreedor
tipo string tipo de la factura contable: 'Emitida', 'EmitidaDevolucionEfectos', 'EmitidaExentaIVA', 'Recibida', 'RecibidaExentaIVA', 'EmitidaIntracomunitaria', 'RecibidaIntracomunitaria', 'EmitidaAtipicos', 'RecibidaAtipicos', 'RecibidaInversion', 'EmitidaRectificativa', 'RecibidaRectificativa', 'EmitidaDepositoFiscal', 'RecibidaImportacion'
fecha_factura datetime fecha de facturacion
fecha_registro datetime fecha del registro
tipo_iva string tipo de iva del registro: 'Soportado', 'Repercutido'
total_sin_impuestos decimal total de la factura sin impuestos
total_con_impuestos decimal total de la factura con impuestos
subcuenta Subcuenta subcuenta contable asociada con la factura
forma_de_pago FormaPago forma de pago de la factura

FiltroDescuentos

Representa un filtro para filtrar la obtención de la lista de descuentos de precios de artículos. 

{
    "cliente_id": "74ea6353-8143-11eb-9163-34e1acf9de8d",
    "formatos_ids": [
        "25e5ed69-af72-14ec-8a1f-d41b8495312e",
        "021168a2-9725-4332-90bc-f0f2b44acc20"
    ]
}
Campo Tipo Descripción
cliente_id uuid identificador de InterlocutorComercial de tipo cliente.
formatos_ids [uuid] lista de ids de artículos formatos.

FiltroTarifas

Representa un filtro para filtrar la obtención de lista de tarifas de precios. 

{
    "cliente_id": "3fdbc085-1a1a-4c00-9add-8584946a6ed3",
    "fecha": "2023-02-14T00:00:00",
    "formatos_ids": [
        "020068a2-9725-4222-80bc-f0f2b11fcc20",
        "021f210f-9892-4aca-826f-c1adeddba7c9",
        "02753ef4-ff8a-4725-8a62-9f17e4c1098f"
    ]
}
Campo Tipo Descripción
cliente_id uuid identificador de InterlocutorComercial de tipo cliente.
fecha datetime fecha para obtener la tarifa
formatos_ids [uuid] lista de ids de artículos formatos

FiltroTesoreria

Representa un filtro de tesoreria para filtrar los efectos o deudas.
Puede indicar el interlocutor_id, subcuenta_codigo o interlocutor_codigo y interlocutor_tipo para obtener deuda de un interlocutor. Puede indicar solo interlocutor_tipo para obtener la deuda de todos los interlocutores del tipo indicado. 

{
    "fecha_hasta": "2023-02-01T00:00:00",
    "interlocutor_codigo": "20",
    "interlocutor_id": "",
    "interlocutor_tipo": "cliente",
    "solo_deuda": false,
    "subcuenta_codigo": ""
}
Campo Tipo Descripción
interlocutor_id uuid identificador de un interlocutor. Opcional.
interlocutor_codigo string código de un interlocutor. Indica interlocutor_tipo. Opcional.
interlocutor_tipo string tipo de interlocutor: cliente, proveedor, acreedor. Opcional si no se ha indicado el código de interlocutor.
subcuenta_codigo string código de subcuenta. Opcional.
fecha_hasta datetime fecha hasta la cual se van a obtener las deudas o efectos. Opcional.
solo_deuda bool true para mostrar solo documentos de deuda, false para mostrar las deudas y los efectos.

FormaPago

Representa una forma de pago 

{
    "abreviatura": "ef",
    "codigo": "contado",
    "descripcion": "Efectivo contado",
    "plazos": [],
    "tipo_documento": "Efectivo"
}
Campo Tipo Descripción
codigo string código de la forma de pago
descripcion string descripción de la forma de pago
abreviatura string abreviatura de la forma de pago
tipo_documento string tipo de la forma de pago: 'Efectivo', 'Cheque', 'Pagare', 'Giro', 'Transferencia', 'Confirming', 'Electronico'
plazos [integer, ] plazos de vencimiento en días desde la fecha servicio del documento. Si hay varios días vence solo la parte proporcional del importe del documento en cada plazo.

Formato

Representa un formato del artículo. 

{
    "baja": false,
    "cajas_fila": 0,
    "cajas_palet": 50,
    "codigo": "1045-24",
    "control_stock": true,
    "descripcion": "San Miguel 1/3 24x",
    "envase_id": "36c06667-0069-4cca-9455-0847daed37eb",
    "equivalencia": 24.0,
    "es_peso": false,
    "es_peso_unitario": false,
    "etiquetas": [
        {
            "descripcion": "cerveza nacional",
            "nombre": "nacional"
        },
        {
            "descripcion": "",
            "nombre": "tercio"
        }
    ],
    "id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "litros": 0.33,
    "nivel_refrigeracion": "SinFrio",
    "nombre": "San Miguel 1/3 Caja 24 botellas",
    "peso": 9.6,
    "peso_neto": 7.2,
    "peso_por_defecto": 0.0,
    "precio_unidad_kg": false,
    "tasas": [
        {
            "tipo": "SIG",
            "valor": 0.05
        }
    ],
    "tipo": "caja",
    "tipo_formato": "venta",
    "unidad_medida": "Caja",
    "unidades_fraccion": 24,
    "volumen": 0.0072
}
Campo Tipo Descripción
id uuid identificador del formato
tipo string tipo de formato: unidad o caja
tipo_formato string tipo de formato: compra, venta o generico
codigo string código del formato
nombre string nombre de formato
descripcion string descripción abreviada del formato
equivalencia decimal número de unidades incluidas en el formato (por ejemplo pack de 6, caja de 4 botellas)
baja bool true si el formato está de baja
peso decimal peso en kilogramos
peso_neto decimal peso del producto neto en kilogramos
peso_por_defecto decimal en los productos que hay que pesar, esto es peso por defecto de la pieza ej. 6.5 para una pieza de jamón. Esto no es aplicable a los artículos que se venden a granel.
volumen decimal volumen del embalaje en m3
litros decimal volumen del producto liquido en litros
tasas [FormatoTasa, ] lista de tasas aplicables al formato
etiquetas [Etiqueta, ] lista de etiquetas asociadas con el formato
unidad_medida string nombre de la unidad de medida de formato ej. unidad, caja, paquete, botella etc.
unidades_fraccion decimal numero de unidades dentro de la caja
control_stock bool si cuenta para stock
nivel_refrigeracion string nivel de refrigeración (Sin frio, Frio positivo, Frio negativo)
envase_id uuid identificador del envase asociado
cajas_palet integer número de cajas en un palet
cajas_fila integer número de cajas en una fila
es_peso bool true si el tipo de articulo es de peso (granel)
es_peso_unitario bool true si el tipo de articulo es de peso unitario (piezas)
precio_unidad_kg bool true si el precio del tipo de articulo es del kg o de una unidad

FormatoStock

Representa información sobre el stock disponible del Formato 

{
    "almacen_codigo": "001",
    "almacen_nombre": "General",
    "fecha_stock": "2021-03-08T15:00:00",
    "formato_codigo": "1045-24",
    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "formato_nombre": "San Miguel 1/3 Caja 24 botellas",
    "precio_inventario": 19.9,
    "stock": 15.0,
    "stock_comprometido": 5.0,
    "stock_disponible": 12.0,
    "stock_transito": 2.0,
    "stock_valoracion": 15.0
}
Campo Tipo Descripción
formato_id uuid identificador del formato
formato_codigo string código del formato
formato_nombre string nombre de formato
almacen_codigo string código del almacen
almacen_nombre string nombre de almacen
stock decimal stock disponible a la fecha indicada
fecha_stock datetime fecha y hora de validez de stock
stock_disponible decimal stock disponible (stock - stock_comprometido + stock_transito) a la fecha indicada
stock_comprometido decimal stock comprometido a la fecha indicada. Normalmente cantidad en pedidos pendientes de servir.
stock_transito decimal stock en tránsito a la fecha indicada. Normalmente cantidad en compras pendientes recepción.
stock_valoracion decimal cantidad de stock para valoración de almacén. Para cajas y botellas este valor coincide con stock, para artículos de peso indica el peso total.
precio_inventario decimal precio de la unidad/caja o precio de kg para artículos de peso

FormatoTasa

Representa una tasa aplicable al formato 

{
    "tipo": "SIG",
    "valor": 0.05
}
Campo Tipo Descripción
tipo string tipo de la tasa: SIG (Sistema integrado de gestión), IBAE5, IBAE8 (Impuesto sobre las bebidas azucaradas envasadas, 5-8g, >8g)
valor decimal valor de la tasa en euros

IdentificacionFiscal

Representa una identificación fiscal. 

{
    "codigo_documento": "G98798798",
    "direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "forma_juridica": "V",
    "idfiscal_id": "05cd76fc-8236-4bfb-a5a2-dfe55647356e",
    "nombre": "Fundacion Pepe Lopez",
    "tipo_documento": "DNI"
}
Campo Tipo Descripción
idfiscal_id uuid identificador de la identicación fiscal
forma_juridica string forma jurídica: A, B, C,... (definidas en Hacienda)
tipo_documento string tipo del documento: CIF, DNI, ...
codigo_documento string código del documento: número del CIF, número del DNI, ...
nombre string razón social
direccion Direccion Dirección fiscal.

IdentificacionFiscalResumen

Representa una versión reducida de las identificaciones fiscales 

{
    "codigo_documento": "B98798757",
    "forma_juridica": "B",
    "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
    "nombre": "GRUPO HOSTELEROS S.L.",
    "tipo_documento": "CIF"
}
Campo Tipo Descripción
idfiscal_id uuid identificador de la identicación fiscal
forma_juridica string forma jurídica: A, B, C,... (definidas en Hacienda)
tipo_documento string tipo del documento: CIF, DNI, ...
codigo_documento string código del documento: número del CIF, número del DNI, ...
nombre string razón social

ImportePercibidoMetalico

Representa el importe percibido en metálico de cobros del ejercicio actual 

{
    "ejercicio_documento": 2023,
    "importe_percibido_metalico_calculo": 12500.0,
    "importe_percibido_metalico_declaracion": 12500.0
}
Campo Tipo Descripción
ejercicio_documento integer ejercicio del documento
importe_percibido_metalico_calculo decimal importe en metálico calculado
importe_percibido_metalico_declaracion decimal importe en metálico a declarar

Impuesto

Representa el impuesto asociado con el artículo. 

{
    "base": 100.0,
    "descripcion": "IVA general",
    "grupo": "general",
    "iva": 21.0,
    "recargo": 5.2
}
Campo Tipo Descripción
descripcion string descripción del impuesto
grupo string indica el tipo de IVA: general, reducido, super reducido, exento
base decimal porcentaje de base al que hay que aplicar el impuesto
iva decimal porcentaje de impuesto
recargo decimal porcentaje de recargo

InformeGrupo

Representa una agrupación para informe. 

{
    "articulos": [],
    "nombre": "CERVEZAS",
    "subgrupos": [
        {
            "articulos": [
                {
                    "baja": false,
                    "cajas_fila": 0,
                    "cajas_palet": 50,
                    "codigo": "1045-24",
                    "control_stock": true,
                    "descripcion": "San Miguel 1/3 24x",
                    "envase_id": "36c06667-0069-4cca-9455-0847daed37eb",
                    "equivalencia": 24.0,
                    "es_peso": false,
                    "es_peso_unitario": false,
                    "etiquetas": [
                        {
                            "descripcion": "cerveza nacional",
                            "nombre": "nacional"
                        },
                        {
                            "descripcion": "",
                            "nombre": "tercio"
                        }
                    ],
                    "id": "000d2ddd-95ea-4a45-9d0d-ef381150e86e",
                    "litros": 0.33,
                    "nivel_refrigeracion": "SinFrio",
                    "nombre": "San Miguel 1/3 Caja 24 botellas",
                    "peso": 9.6,
                    "peso_neto": 7.2,
                    "peso_por_defecto": 0.0,
                    "precio_unidad_kg": false,
                    "tasas": [
                        {
                            "tipo": "SIG",
                            "valor": 0.05
                        }
                    ],
                    "tipo": "caja",
                    "unidad_medida": "Caja",
                    "unidades_fraccion": 24,
                    "volumen": 0.0072
                }
            ],
            "nombre": "CAJA RETORNABLE",
            "subgrupos": []
        },
        {
            "articulos": [
                {
                    "baja": false,
                    "codigo": "1045-1",
                    "control_stock": true,
                    "descripcion": "Barril San Miguel 30",
                    "envase_id": "",
                    "equivalencia": 1.0,
                    "es_peso": false,
                    "es_peso_unitario": false,
                    "etiquetas": [
                        "nacional",
                        "barril"
                    ],
                    "id": "000b32d6-018f-45c0-a93c-3dc785ef24b8",
                    "litros": 30.0,
                    "nivel_refrigeracion": "SinFrio",
                    "nombre": "Barril San Miguel 30",
                    "peso": 4.0,
                    "peso_neto": 3.0,
                    "peso_por_defecto": 0.0,
                    "precio_unidad_kg": false,
                    "tasas": [
                        {
                            "tipo": "SIG",
                            "valor": 1.2
                        }
                    ],
                    "tipo": "unidad",
                    "unidad_medida": "Unidad",
                    "unidades_fraccion": 1,
                    "volumen": 0.0
                }
            ],
            "nombre": "BARRIL",
            "subgrupos": []
        }
    ]
}
Campo Tipo Descripción
nombre string Descripción
subgrupos [InformeGrupo, ] lista de subgrupos que componen el árbol
articulos [Formato, ] lista de artículos que contiene el informe grupo

InterlocutorComercial

Representa un interlocutor comercial como el cliente, proveedor o acreedor. 

{
    "baja": false,
    "canal": "Z",
    "cargar_envases": "documentoaparte",
    "codigo": "10000",
    "codigo_barras": "",
    "contactos": [
        {
            "cargo": "Director",
            "email": "[email protected]",
            "fax": "",
            "fijo": "+34123123123",
            "movil": "+34321321321",
            "nombre": "Pepe Lopez"
        }
    ],
    "delegacion": "X",
    "direcciones": [
        {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "latitud": 0.0,
            "longitud": 0.0,
            "pais": "ES",
            "poblacion": "Algemes\u00ed",
            "provincia": "Valencia",
            "tipo": "generica"
        }
    ],
    "documento_entrega": "factura",
    "email_facturacion": "[email protected]",
    "exento_iva": true,
    "exento_sig": false,
    "forma_pago": "contado",
    "forma_pago_resumen": {
        "abreviatura": "ef",
        "codigo": "contado",
        "descripcion": "Efectivo contado",
        "plazos": [],
        "tipo_documento": "Efectivo"
    },
    "hash": 4153754459,
    "id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
    "idfiscal": {
        "codigo_documento": "G98798798",
        "direccion": {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "latitud": 0.0,
            "longitud": 0.0,
            "pais": "ES",
            "poblacion": "Algemes\u00ed",
            "provincia": "Valencia",
            "tipo": "generica"
        },
        "forma_juridica": "V",
        "idfiscal_id": "05cd76fc-8236-4bfb-a5a2-dfe55647356e",
        "nombre": "Fundacion Pepe Lopez",
        "tipo_documento": "DNI"
    },
    "nombre": "MUSEO DE LA FAUNA SALVAJE",
    "referencia_pedido_obligatoria": false,
    "regimen_fiscal": "general",
    "responsable": {
        "clave_dimension": "repartidor",
        "codigo": "RP005",
        "id": "00301270-6e90-407d-813d-b2d26fc526ac",
        "idfiscal": {
            "codigo_documento": "B98798646",
            "forma_juridica": "B",
            "idfiscal_id": "002e9612-4180-4644-aa36-72b201175emp",
            "nombre": "FRANCISCO MONTES MONTES",
            "tipo_documento": "CIF"
        },
        "nombre": "PACO MONTES",
        "subcuenta": ""
    },
    "rutas_reparto": [
        {
            "codigo": "002",
            "descripcion": "Ruta 2",
            "responsable": null,
            "tipo": "reparto"
        }
    ],
    "rutas_venta": [
        {
            "almacen_codigo": "01",
            "almacen_descripcion": "Almacen 1",
            "centro_coste_codigo": "01",
            "centro_coste_descripcion": "Centro de coste 1",
            "codigo": "001",
            "descripcion": "Ruta 1",
            "responsable": {
                "clave_dimension": "comercial",
                "codigo": "RP20",
                "id": "00301290-4a70-4a8d-823d-c2d27fc536",
                "idfiscal": {
                    "codigo_documento": "G95445782",
                    "direccion": {
                        "codigo_postal": "46680",
                        "direccion": "Calle Museo 34",
                        "latitud": 0.0,
                        "longitud": 0.0,
                        "pais": "ES",
                        "poblacion": "Algemes\u00ed",
                        "provincia": "Valencia",
                        "tipo": "generica"
                    },
                    "forma_juridica": "V",
                    "idfiscal_id": "06cd76fc-8a36-4bhb-a7a2-dfe59648352e",
                    "nombre": "Alfonso",
                    "tipo_documento": "DNI"
                },
                "nombre": "Alfonso"
            },
            "tipo": "venta"
        }
    ],
    "subcuenta": "430010000",
    "tarifa": "D",
    "tipo": "cliente",
    "tipo_distribucion": "Directa",
    "tipo_distribucion_tipo": "b2c",
    "tiposcliente": [
        {
            "codigo": "bar",
            "descripcion": "BARES"
        }
    ]
}
Campo Tipo Descripción
id uuid identificador único del interlocutor
tipo string tipo de interlocutor: cliente, proveedor, acreedor
codigo string código de interlocutor
nombre string nombre de interlocutor
subcuenta string numero de subcuenta contable
idfiscal IdentificacionFiscal identificación fiscal asociada con el interlocutor
email_facturacion string correo electrónico de facturación
codigo_barras string código de barras asociado con el interlocutor
regimen_fiscal string tipo de régimen fiscal: general, recargo, exento
exento_sig bool true si el interlocutor es exento de SIG (ecotasa)
exento_iva bool true si el interlocutor es exento de IVA
referencia_pedido_obligatoria bool true si hay que indicar la referencia de pedido del cliente.
cargar_envases string indica si hay que cargar los envases: cargar, nocargar, documento_aparte o cadena vacía si no es aplicable.
documento_entrega string indica el tipo de documento de entrega al cliente: albaran, factura o cadena vacía si no es aplicable.
tarifa string Código de la tarifa por defecto
forma_pago string Código de la forma de pago
forma_pago_resumen FormaPago forma de pago del interlocutor
direcciones [Direccion, ] la lista de las direcciones del interlocutor
contactos [Contacto, ] la lista de contactos de interlocutor
baja bool true si el cliente esta de baja
tiposcliente [TipoCliente, ] la lista de tipos de cliente. Este campo solo esta disponible si el tipo es cliente. El primer tipo es genérico, las demás tipos dependen del fabricante.
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que el interlocutor, dirección o datos fiscales cambian.
delegacion string Clave de dimensión del centro de costes. Este campo solo esta disponible para cliente.
canal string Clave de dimensión del centro de costes. Este campo solo esta disponible para cliente.
rutas_venta [Ruta, ] Lista de rutas de tipo venta a las que pertenece el cliente. Este campo solo esta disponible para cliente.
rutas_reparto [Ruta, ] Lista de rutas de tipo reparto a las que pertenece el cliente. Este campo solo esta disponible para cliente.
tipo_distribucion string Tipo/canal de distribución. Este campo solo esta disponible para cliente.
tipo_distribucion_tipo string Tipo página web del tipo de distribución: b2b, b2c, b2d. Este campo solo está disponible para cliente.
responsable Empleado Responsable de venta por defecto del cliente. Este campo solo esta disponible para cliente.

InterlocutorComercialResumen

Representa un resumen de interlocutor comercial como el cliente, proveedor o acreedor. 

{
    "codigo": "10001",
    "hash": 0,
    "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
    "nombre": "GRUPO HOSTELEROS S.L.",
    "tipo": "cliente"
}
Campo Tipo Descripción
id uuid identificador único del interlocutor
tipo string tipo de interlocutor: "cliente", "proveedor", "acreedor"
codigo string código de interlocutor
nombre string nombre de interlocutor
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que el interlocutor cambia.

Modelo347

Representa un registro de datos para la declaración del modelo 347. 

{
    "clave_operacion": "A",
    "detalles": [
        {
            "documento": "11111111",
            "fecha": "2021-04-14T00:00:00",
            "importe": 12100.0
        },
        {
            "documento": "0312463896",
            "fecha": "2021-07-29T00:00:00",
            "importe": 1619.69
        }
    ],
    "ejercicio": 2021,
    "id": "7205e4ed-4606-11ec-a736-fa163e6ae230",
    "idfiscal": {
        "codigo_documento": "B98798757",
        "forma_juridica": "B",
        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
        "nombre": "GRUPO HOSTELEROS S.L.",
        "tipo_documento": "CIF"
    },
    "importe_percibido_metalico_calculo": 0.0,
    "importe_percibido_metalico_declarar": 0.0,
    "importe_trimestre_1_calculo": 0.0,
    "importe_trimestre_1_declarar": 0.0,
    "importe_trimestre_2_calculo": 12100.0,
    "importe_trimestre_2_declarar": 12100.0,
    "importe_trimestre_3_calculo": 1619.69,
    "importe_trimestre_3_declarar": 1619.69,
    "importe_trimestre_4_calculo": 0.0,
    "importe_trimestre_4_declarar": 0.0,
    "importes_percibido_metalico": [],
    "validado": true
}
Campo Tipo Descripción
id uuid Identificador del registro. Utiliza el identificador para validar el registro.
ejercicio integer ejercicio
idfiscal IdentificacionFiscalResumen identificación fiscal al que pertenece el registro
clave_operacion string la clave según el modelo 347. Uno de 'A', 'B', 'C', 'D', 'E', 'F', 'G'
importe_trimestre_1_calculo decimal importe acumulado del trimestre 1
importe_trimestre_2_calculo decimal importe acumulado del trimestre 2
importe_trimestre_3_calculo decimal importe acumulado del trimestre 3
importe_trimestre_4_calculo decimal importe acumulado del trimestre 4
importe_trimestre_1_declarar decimal importe a declarar en el trimestre 1
importe_trimestre_2_declarar decimal importe a declarar en el trimestre 2
importe_trimestre_3_declarar decimal importe a declarar en el trimestre 3
importe_trimestre_4_declarar decimal importe a declarar en el trimestre 4
importes_percibido_metalico [ImportesPercibidoMetalico] lista de importes en metalico
importe_percibido_metalico_calculo decimal importe en metálico calculado correspondiente a documentos del ejercicio actual
importe_percibido_metalico_declarar decimal importe en metálico a declarar correspondiente a documentos del ejercicio actual
validado bool true si los importes a declarar han sido validadas. Utiliza /api_v1/modelo347_validar/ para validar el registro.
detalles [Modelo347Detalle, ] lista de documentos incluidos en los totales

Modelo347Detalle

Representa un documento incluido en los totales de los importes de Modelo347 

{
    "documento": "11111111",
    "fecha": "2021-04-14T00:00:00",
    "importe": 12100.0
}
Campo Tipo Descripción
documento string serie y numero de documento
fecha datetime fecha del documento
importe decimal importe del documento

MovimientoAlmacen

Representa un movimiento de almacen. 

{
    "codigo_controlador": "",
    "codigo_repartidor": "",
    "documento": "Ped123",
    "fecha_documento": "2022-03-03T00:00:00",
    "fecha_servicio": "2022-03-03T00:00:00",
    "lineas": [
        {
            "articulo_id": "64374d6e-af52-11ec-b1dc-d41b8144312e",
            "cantidad_valoracion": 5.0,
            "codigo_articulo": 1,
            "codigo_formato": 1,
            "descripcion_articulo": "Barril amstel 50L",
            "descripcion_formato": "Barril amstel 50L",
            "descripcion_tipo_articulo": "Producto",
            "equivalencia": 1,
            "formato_id": "25e5ed69-af52-11ec-8a0f-d41b8144312e",
            "precio": 7.5,
            "tipo_articulo": "producto",
            "tipo_formato": "unidad",
            "unidades_pedidas": 5,
            "unidades_servidas": 5
        }
    ],
    "matricula": "",
    "nombre_controlador": "",
    "nombre_repartidor": "",
    "tipo_pedido": "compras",
    "tipo_vehiculo": "",
    "total_bultos": 10,
    "total_pedidos": 1,
    "total_peso": 0
}
Campo Tipo Descripción
documento string serie y número de pedido.
tipo_pedido string tipo de pedido: 'compras', 'salida hoja carga', 'entrada hoja carga', 'devolucion hoja carga', 'rotura hoja carga', 'ajuste'.
fecha_documento datetime fecha del documento del pedido.
fecha_servicio datetime fecha de servicio del pedido.
matricula string matrícula del vehículo asociado al pedido.
tipo_vehiculo string tipo de vehículo: 'reparto', 'reparto externo', 'transporte', 'transporte externo'.
codigo_repartidor string codigo del repartidor asociado al pedido.
nombre_repartidor string nombre del repartidor.
codigo_controlador string codigo del controlador asociado al pedido.
nombre_controlador string nombre del controlador.
total_bultos decimal total de bultos del pedido.
total_peso decimal total peso del pedido.
total_pedidos decimal total de pedidos.
lineas [MovimientoLinea, ] lineas de los movimientos de almacen.

MovimientoLinea

Representa una línea de un movimiento almacen. 

{
    "articulo_id": "64374d6e-af52-11ec-b1dc-d41b8144312e",
    "cantidad_valoracion": 5.0,
    "codigo_articulo": 1,
    "codigo_formato": 1,
    "descripcion_articulo": "Barril amstel 50L",
    "descripcion_formato": "Barril amstel 50L",
    "descripcion_tipo_articulo": "Producto",
    "equivalencia": 1,
    "formato_id": "25e5ed69-af52-11ec-8a0f-d41b8144312e",
    "precio": 7.5,
    "tipo_articulo": "producto",
    "tipo_formato": "unidad",
    "unidades_pedidas": 5,
    "unidades_servidas": 5
}
Campo Tipo Descripción
articulo_id string id del artículo.
codigo_articulo string código del artículo.
descripcion_articulo string descripción del articulo.
formato_id string id del formato.
codigo_formato string código del formato.
descripcion_formato string descripción del formato.
equivalencia decimal número de unidades incluidas en el formato (por ejemplo pack de 6, caja de 4 botellas).
tipo_formato string tipo de formato: compra, venta o generico.
tipo_articulo string tipo del artículo: 'producto', 'envase', 'plv', 'valor anadido', 'aportacion cash', 'atipico', 'cargo'.
descripcion_tipo_articulo string descripción del tipo de producto, producto, envase, embalaje, valor anadido...
unidades_pedidas decimal unidades solicitadas en el pedido.
unidades_servidas decimal unidades recibidas o servidas en el pedido.
precio decimal precio de compra de los artículos del pedido.
cantidad_valoracion decimal cantidad de mercancía para valorar la línea. Normalmente coincide con cantidad entregada, pero indica peso en los artículos de peso

PartidasCompensadas

Representa las partidas compensadas de la deuda (Cobros) 

{
    "documento_de_saldo": {
        "fecha_documento": "2023-07-03T00:00:00",
        "fecha_operacion": "2023-07-03T00:00:00",
        "fecha_vencimiento": "2023-07-03T00:00:00",
        "liquidado": false,
        "pendiente": 0.0,
        "referencia": "65348",
        "tesoreria_deuda_id": "900748a2-9725-4222-80bc-f0f2b11lpc20"
    },
    "operaciones": [
        {
            "estado": "Cerrada",
            "fecha": "2023-07-03T00:00:00",
            "importe": 132.89,
            "tesoreria_operacion_id": "900068a2-34r25-4222-80bc-f0f2b11hjc20",
            "tipo": "Cobros"
        }
    ],
    "tesoreria_efectos": [
        {
            "documento": 10987,
            "estado": "En cartera",
            "fecha_documento": "2023-07-03T00:00:00",
            "fecha_vencimiento": "2023-07-03T00:00:00",
            "importe": 0.0,
            "tesoreria_cartera_efecto_id": "900068a2-juh5-4222-80bc-f0f2671fcc20",
            "tipo": "Cobro",
            "tipo_documento": "Cheque"
        }
    ]
}
Campo Tipo Descripción
documento_de_saldo TesoreriaDeudaResumen documento con el que se ha saldado la deuda
tesoreria_efectos [TesoreriaCarteraEfecto, ] lista de efectos en la cartera de efectos: cheque, pagare o giro
operaciones [TesoreriaMovimientoOperacion, ] lista de operaciones de tesoreria

Pedido

Representa un pedido para grabar en winfra. 

{
    "cliente_direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "cliente_nombre": "Pepe Lopez",
    "comentario": "Entregar por la ma\u00f1ana",
    "email": "[email protected]",
    "identicket": "",
    "identificador": "",
    "idfiscal": {
        "codigo_documento": "B321321",
        "direccion": {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "latitud": 0.0,
            "longitud": 0.0,
            "pais": "ES",
            "poblacion": "Algemes\u00ed",
            "provincia": "Valencia",
            "tipo": "generica"
        },
        "nombre": "Pepe Lopez S.A.",
        "tipo_documento": "CIF"
    },
    "lineas": [
        {
            "cantidad": 2.0,
            "descuentos": [
                {
                    "tipo": "porcentaje",
                    "valor": 15.0
                }
            ],
            "formato_codigo": "",
            "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
            "precio": 1.5
        }
    ],
    "telefono": "+34123123123",
    "total_con_impuestos": 29.64
}
Campo Tipo Descripción
cliente_nombre string Nombre/apellidos del cliente
cliente_direccion Direccion Dirección de la entrega de pedido
comentario string Comentario del cliente/información adicional
telefono string telefono de contacto
email string dirección de correo electrónico del cliente
total_con_impuestos decimal total del pedido con impuestos que se utiliza para confirmar la valoración correcta del pedido.
identicket string Identicket. Opcional.
identificador string Identificador de pedido del cliente. Opcional.
lineas [PedidoLinea, ] lineas de pedido
idfiscal PedidoIdentificacionFiscal identificación fiscal del cliente para generar factura a su nombre/empresa. Este campo es opcional.

PedidoCRM

Representa un pedido para grabar en winfra proveniente de un sistema CRM. A diferencia de Pedido el PedidoCRM genera un pedido para el InterlocutorComercial que ya existe. 

{
    "cliente_codigo": "",
    "cliente_id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
    "comentario": "servir por la ma\u00f1ana",
    "dto_pronto_pago": 1.0,
    "fecha_documento": "2020-09-18T00:00:00",
    "fecha_servicio": "2020-09-21T00:00:00",
    "identicket": "",
    "identificador": "",
    "lineas": [
        {
            "cantidad": 2.0,
            "descuentos": [
                {
                    "campana_id": "",
                    "euros": 0.0,
                    "porcentaje": 15.0,
                    "precio": 0.0,
                    "regalo": 0.0,
                    "tipo": "porcentaje"
                }
            ],
            "formato_codigo": "",
            "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
        }
    ],
    "lotes": [
        {
            "lineas": [
                {
                    "cantidad": 10.0,
                    "descuentos": [],
                    "formato_codigo": "",
                    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
                },
                {
                    "cantidad": 1.0,
                    "descuentos": [
                        {
                            "campana_id": "",
                            "euros": 0.0,
                            "porcentaje": 100.0,
                            "precio": 0.0,
                            "regalo": 0.0,
                            "tipo": "porcentaje"
                        }
                    ],
                    "formato_codigo": "",
                    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
                }
            ],
            "lote_codigo": "Lote 10+1",
            "lote_id": "fa903db3-323e-401f-a822-f1cba229185e"
        }
    ]
}
Campo Tipo Descripción
cliente_id uuid identificador de InterlocutorComercial de tipo cliente. Este campo es opcional si se ha indicado cliente_codigo.
cliente_codigo string código de InterlocutorComercial de tipo cliente. Este campo es opcional.
dto_pronto_pago decimal Un porcentaje de descuento de pronto pago aplicado al documento.
comentario string comentario o información adicional
fecha_documento datetime fecha de creación/toma del pedido
fecha_servicio datetime fecha deseada de la entrega
identicket string identicket
identificador string identificador de pedido del cliente
lineas [PedidoCRMLinea, ] lineas de venta
lotes [PedidoCRMLote, ] lotes de artículos. Este campo es opcional.

PedidoCRMDescuento

Representa un descuento aplicado desde CRM a la linea de venta. 

{
    "campana_id": "",
    "euros": 0.0,
    "porcentaje": 15.0,
    "precio": 0.0,
    "regalo": 0.0,
    "tipo": "porcentaje"
}
Campo Tipo Descripción
campana_id uuid identificador de la campaña. Este campo es opcional.
tipo string tipo de la condicion: porcentaje, euros, precio, regalo
porcentaje decimal un porcentaje de descuento. Este campo es opcional, según el tipo.
euros decimal cantidad de euros de descuento por formato. Este campo es opcional, según el tipo.
precio decimal un precio especial aplicable en lugar de la tarifa. Este campo es opcional, según el tipo.
regalo decimal la cantidad regalada. Para un 2+1 (paga 2 llevate 3) es regalo=1 y PedidoCRMLinea.cantidad=3. Este campo es opcional, según el tipo.

PedidoCRMLinea

Representa un linea de pedido de CRM que se va a grabar en Winfra. Indica el formato_id o opcionalmente el formato_codigo. 

{
    "cantidad": 2.0,
    "descuentos": [
        {
            "campana_id": "",
            "euros": 0.0,
            "porcentaje": 15.0,
            "precio": 0.0,
            "regalo": 0.0,
            "tipo": "porcentaje"
        }
    ],
    "formato_codigo": "",
    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
}
Campo Tipo Descripción
formato_id uuid identificador del formato del artículo. Este campo es opcional si se ha indicado formato_codigo
formato_codigo string código del formato del artículo. Este campo es opcional.
cantidad decimal la cantidad para entregar, incluye regalos. Indica la cantidad regalada como descuento.
descuentos [PedidoCRMDescuento, ] descuentos aplicados sobre la línea. Este campo es opcional.

PedidoCRMLote

Representa un lote de articulos (promoción cruzada). Indica el lote_id o opcionalmente el lote_codigo. El lote contiene lineas de artículos.
Indica un descuento en las lineas de regalo del lote. Véase el ejemplo. 

{
    "lineas": [
        {
            "cantidad": 10.0,
            "descuentos": [],
            "formato_codigo": "",
            "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
        },
        {
            "cantidad": 1.0,
            "descuentos": [
                {
                    "campana_id": "",
                    "euros": 0.0,
                    "porcentaje": 100.0,
                    "precio": 0.0,
                    "regalo": 0.0,
                    "tipo": "porcentaje"
                }
            ],
            "formato_codigo": "",
            "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
        }
    ],
    "lote_codigo": "Lote 10+1",
    "lote_id": "fa903db3-323e-401f-a822-f1cba229185e"
}
Campo Tipo Descripción
lote_id uuid identificador del lote de los artículos. Este campo es opcional si se ha indicado lote_codigo.
lote_codigo string código del lote de artículos. Este campo es opcional.
lineas [PedidoCRMLinea, ] lineas de venta de los artículos que forman parte de lote.

PedidoCobro

Representa un cobro para grabar en winfra. 

{
    "codigo_vendedor": "VT0001",
    "cuenta_tesoreria_id_electronico": "",
    "deuda_id": "",
    "entidad_cheque": "1111",
    "fecha_cobro": "2021-04-24T00:00:00",
    "fecha_emision_cheque": "2021-05-24T00:00:00",
    "fecha_vencimiento_cheque": "2021-04-24T00:00:00",
    "forma_pago": "Cheque",
    "importe": 50.0,
    "numero_cheque": "1234567891",
    "numero_documento": "F2021001",
    "oficina_cheque": "2222"
}
Campo Tipo Descripción
codigo_vendedor string Código del Vendedor.
numero_documento string Código del documento cobrados (serie+número).
deuda_id string Identificador de deuda. Puede indicar Tesoreria_Deuda_Id en lugar de numero_documento. Es obligatorio indicar numero_documento o deuda_id. Si indica los dos utilizamos deuda_id.
fecha_cobro datetime Fecha de creación del cobro.
importe decimal Importe cobrado.
forma_pago string Forma de Pago (Efectivo,Cheque,Pagare,Electronico).
numero_cheque string Número de cheque.
entidad_cheque string Entidad bancaria.
oficina_cheque string Oficina bancaria.
fecha_vencimiento_cheque datetime Fecha de vencimiento del cheque.
fecha_emision_cheque datetime Fecha de emision del cheque.
cuenta_tesoreria_id_electronico string Identificador de la cuenta tesoreria de la forma de pago Electronico.

PedidoConfirmacion

Los datos necesarios para confirmar pedido subido a winfra. 

{
    "codigo_autorizacion": "003555",
    "codigo_orden": "1590751280",
    "importe": 0.0,
    "transaccion_id": "90002091-dd89-11ea-a983-54e1ade9de7d"
}
Campo Tipo Descripción
transaccion_id uuid identificador de la transacción. Subida de los pedidos devuelve el transaccion_id.
importe decimal importe cobrado de la transacción. Este valor debería coincidir con el Pedido.total_con_impuestos. El valor es obligatorio con la integración directa de los pedidos.
codigo_autorizacion string código de autorización de pago
codigo_orden string código de orden de pago

PedidoDescuento

Representa un descuento aplicado a una linea de pedido. 

{
    "tipo": "porcentaje",
    "valor": 15.0
}
Campo Tipo Descripción
tipo string tipo de la condicion: porcentaje, euros, regalo
valor decimal el descuento aplicado, según el tipo el valor representa cantidad de porcentajes, euros por unidad o cantidad regalada

PedidoIdentificacionFiscal

Identificación fiscal del cliente para la confirmación del pedido en caso que hay que generar la factura a su nombre/empresa 

{
    "codigo_documento": "B321321",
    "direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "nombre": "Pepe Lopez S.A.",
    "tipo_documento": "CIF"
}
Campo Tipo Descripción
tipo_documento string tipo del documento: CIF, DNI, ...
codigo_documento string código del documento: número del CIF, número del DNI, ...
nombre string razón social
direccion Direccion dirección fiscal del cliente

PedidoLinea

Representa un linea de pedido que se va a grabar en winfra. Indica el formato_id o opcionalmente el formato_codigo. 

{
    "cantidad": 2.0,
    "descuentos": [
        {
            "tipo": "porcentaje",
            "valor": 15.0
        }
    ],
    "formato_codigo": "",
    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "precio": 1.5
}
Campo Tipo Descripción
formato_id uuid identificador del formato del artículo. Este campo es opcional si se ha indicado el formato_codigo
formato_codigo string código del formato del artículo. Este campo es opcional.
precio decimal precio de venta. Este campo es opcional.
cantidad decimal la cantidad vendida
descuentos [PedidoDescuento, ] descuentos aplicados a la linea. Si no esta en modo de integración directa no hace falta indicar los descuentos.

PedidoTransaccion

Indica la transacción a la que pertenece el pedido subido para grabar en winfra. Incluye información de estado de pedido. 

{
    "estado": "confirmado",
    "fecha_creacion": "2020-09-21T12:24:36",
    "transaccion_id": "90002091-dd89-11ea-a983-54e1ade9de7d",
    "ventas": [
        {
            "bultos": 1.0,
            "estado": "Bloqueado",
            "fecha_documento": "2020-10-28T00:00:00",
            "fecha_servicio": "2020-10-28T00:00:00",
            "hash": 456724,
            "id": "3b433c26-7032-11eb-82dd-54e1ade9de7d",
            "numero": 820,
            "serie": "20T/",
            "tipo_documento": "Factura Directa",
            "total": 30.0,
            "total_con_impuestos": 33.0
        }
    ]
}
Campo Tipo Descripción
transaccion_id uuid identificador de la transacción. Utilizalo para confirmar los pedidos.
fecha_creacion datetime fecha y hora de la creación de transacción - subida del pedido
estado string representa el estado del pedido:
  • desconocido - el pedido no esta en Winfra o alguien lo ha eliminado
  • sin_confirmar - el pedido está en Winfra pendiente de confirmación por la plataforma de ecommerce
  • confirmado - el pedido se ha confirmado en Winfra
  • en_preparacion - el pedido se está preparando
  • despachado - el pedido está en tránsito
ventas [VentaResumen] uno o varios documentos de venta generados

PeticionGenerarXXL

Representa la petición para generar los datos de carga masiva. Además del dataset y el webhook puede indicar otros parámetros según el dataset indicado. 

{
    "dataset": "interlocutores",
    "webhook": "https://www.ejemplo.com/"
}
Campo Tipo Descripción
dataset string Identificador del conjunto de datos que vamos a generar.
webhook string Url de su servidor donde recibirá una llamada POST de EstadoGenerarXXL una vez que haya finalizado la generación. Este campo es opcional.

RegistroIva

Representa un registro de I.V.A. 

{
    "desgloses": [
        {
            "base": 1210.0,
            "cuota_iva": 254.1,
            "cuota_recargo": 62.92,
            "grupo": "general",
            "iva": 21.0,
            "recargo": 5.2
        }
    ],
    "factura": "F20001",
    "fecha": "2020-05-30T00:00:00",
    "fecha_expedicion": "2020-05-30T00:00:00",
    "idfiscal": {
        "codigo_documento": "B98798757",
        "forma_juridica": "B",
        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
        "nombre": "GRUPO HOSTELEROS S.L.",
        "tipo_documento": "CIF"
    },
    "numero_emitido": 20001,
    "numero_recepcion": 0,
    "serie_emitida": "F",
    "tipo": "Expedidas",
    "tipo_iva": "Repercutido"
}
Campo Tipo Descripción
idfiscal IdentificacionFiscalResumen identicación fiscal resumida
fecha datetime fecha del registro
fecha_expedicion datetime fecha de la expedición del documento original
factura string documento que identifica el registro
tipo string tipo de registro: Expedidas, Recibidas, Inversion, Intracomunitarias
tipo_iva string tipo de iva del registro: Soportado, Repercutido
numero_recepcion string número de recepción del registro
desgloses [DesgloseIva, ] lista de detalles del registro
serie_emitida string serie del documento para los documentos expedidos
numero_emitido integer numero del documento para los documentos expedidos

Ruta

Representa una ruta de reparto o una ruta de venta a la que pertenece el cliente. 

{
    "almacen_codigo": "01",
    "almacen_descripcion": "Almacen 1",
    "centro_coste_codigo": "01",
    "centro_coste_descripcion": "Centro de coste 1",
    "codigo": "001",
    "descripcion": "Ruta 1",
    "responsable": {
        "clave_dimension": "comercial",
        "codigo": "RP20",
        "id": "00301290-4a70-4a8d-823d-c2d27fc536",
        "idfiscal": {
            "codigo_documento": "G95445782",
            "direccion": {
                "codigo_postal": "46680",
                "direccion": "Calle Museo 34",
                "latitud": 0.0,
                "longitud": 0.0,
                "pais": "ES",
                "poblacion": "Algemes\u00ed",
                "provincia": "Valencia",
                "tipo": "generica"
            },
            "forma_juridica": "V",
            "idfiscal_id": "06cd76fc-8a36-4bhb-a7a2-dfe59648352e",
            "nombre": "Alfonso",
            "tipo_documento": "DNI"
        },
        "nombre": "Alfonso"
    },
    "tipo": "venta"
}
Campo Tipo Descripción
codigo string código de ruta
descripcion string descripción de ruta
tipo string tipo de ruta, uno de: reparto, venta
almacen_codigo string código del almacén asociado a la ruta
almacen_descripcion string descripción del almacén asociado a la ruta
centro_coste_codigo string código del centro de coste del almacén
centro_coste_descripcion string descripción del centro de coste del almacén
responsable Empleado responsable asociado a la ruta

ServerInfo

Contiene información sobre la instalación 

{
    "fechahora": "2020-05-24T13:37:21",
    "version": "20200524"
}
Campo Tipo Descripción
version string Numero de versión de la instalación
fechahora datetime Fecha y hora actual del servidor

Subcuenta

Representa una subcuenta contable. 

{
    "baja": false,
    "centro_coste1_codigo": "COMERC",
    "centro_coste1_descripcion": "COMERCIAL",
    "centro_coste2_codigo": "CERV",
    "centro_coste2_descripcion": "CERVEZA",
    "codigo": "4300011010",
    "descripcion": "BAR EL ABREVADERO",
    "interlocutor_comercial": "C021",
    "proyecto_codigo": "CERV",
    "proyecto_descripcion": "CERVEZA",
    "subcuenta_exportacion": "4300311010"
}
Campo Tipo Descripción
codigo string código de la subcuenta
descripcion string descripción de la cuenta
subcuenta_exportacion string número de la cuenta para exportación, si este difiere del código
interlocutor_comercial string código de interlocutor si es diferente que indica el código
centro_coste1_codigo string código del centro de costes
centro_coste1_descripcion string descripción del centro de costes
centro_coste2_codigo string código del centro de costes
centro_coste2_descripcion string descripción del centro de costes
proyecto_codigo string código de proyecto
proyecto_descripcion string descripción del proyecto
baja bool indica si la subcuenta está de baja

Tarifa

Representa una tarifa de precios de un artículo 

{
    "fecha_desde": "2020-06-01T00:00:00",
    "formato_codigo": "1045-24",
    "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "precio": 12.25,
    "precio_con_impuestos": 13.475
}
Campo Tipo Descripción
formato_id uuid identificador del formato del artículo
formato_codigo string código del formato del artículo
fecha_desde datetime fecha desde la que está en vigor la tarifa
precio decimal precio de tarifa del artículo
precio_con_impuestos decimal precio de tarifa del artículo incluyendo impuestos y tasas (IVA, SIG)

TesoreriaCarteraEfecto

Representa un efecto en la cartera de efectos: cheque, pagare o giro 

{
    "documento": 10987,
    "estado": "En cartera",
    "fecha_documento": "2023-07-03T00:00:00",
    "fecha_vencimiento": "2023-07-03T00:00:00",
    "importe": 0.0,
    "tesoreria_cartera_efecto_id": "900068a2-juh5-4222-80bc-f0f2671fcc20",
    "tipo": "Cobro",
    "tipo_documento": "Cheque"
}
Campo Tipo Descripción
tesoreria_cartera_efecto_id uuid identificador del efecto
documento integer numeracion automatica de los documentos de cartera
tipo_documento string (Cheque, Pagare, Giro, Confirming)
tipo string indica si es un cobro o un pago
importe decimal importe el efecto
fecha_documento datetime fecha de creacion del efecto
fecha_vencimiento datetime fecha de caducidad del efecto
estado string estado del efecto

TesoreriaDeudaResumen

Representa los registros de deuda tanto de cobros como de pagos 

{
    "fecha_documento": "2023-07-03T00:00:00",
    "fecha_operacion": "2023-07-03T00:00:00",
    "fecha_vencimiento": "2023-07-03T00:00:00",
    "liquidado": false,
    "pendiente": 0.0,
    "referencia": "65348",
    "tesoreria_deuda_id": "900748a2-9725-4222-80bc-f0f2b11lpc20"
}
Campo Tipo Descripción
tesoreria_deuda_id uuid identificador de la tesoreria deuda
referencia string (abreviatura + serie + numero) del documento de origen de la deuda
liquidado bool indica si la deuda esta o no liquidada
fecha_documento datetime fecha de creacion del documento
fecha_operacion datetime en ventas fecha de servicio, en compras fecha de albaran, en notas y facturas contables la fecha del documento
fecha_vencimiento datetime fecha de caducidad de la deuda
pendiente decimal importe pendiente de cobrar

TesoreriaMovimientoOperacion

Representa las operaciones de tesoreria iniciadas por el operador 

{
    "estado": "Cerrada",
    "fecha": "2023-07-03T00:00:00",
    "importe": 132.89,
    "tesoreria_operacion_id": "900068a2-34r25-4222-80bc-f0f2b11hjc20",
    "tipo": "Cobros"
}
Campo Tipo Descripción
tesoreria_operacion_id uuid identificador de la operacion
importe decimal importe de las operaciones del tipo que corresponde al sumatorio de sus movimientos
tipo string tipo de operacion que define los desgloses de la misma
fecha datetime fecha operacion
estado string india si la operacion esta abierta o cerrada

TipoCliente

Representa tipo de cliente/clasificación de los establecimientos. 

{
    "codigo": "bar",
    "descripcion": "BARES"
}
Campo Tipo Descripción
codigo string código del tipo
descripcion string descripción del tipo

Vehiculo

Representa un vehículo. 

{
    "baja": false,
    "id": "0651c7aa-c5a7-486d-89c9-7b0f22e530c8",
    "matricula": "11-685DZY",
    "modelo": "MEGANE"
}
Campo Tipo Descripción
id uuid identificador del vehículo
modelo string modelo del vehículo
matricula string matrícula del vehículo
baja bool true si el vehículo está de baja

Venta

Representa documento de venta. 

{
    "almacen_codigo": "001",
    "almacen_nombre": "General",
    "aplicar_flete": false,
    "bultos": 1.0,
    "canal": "Z",
    "cargar_envase": "cargar",
    "cliente": {
        "codigo": "10000",
        "hash": 4153754459,
        "id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
        "nombre": "MUSEO DE LA FAUNA SALVAJE",
        "tipo": "cliente"
    },
    "delegacion": "X",
    "dto_pronto_pago": 0.0,
    "entrega": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "estado": "Bloqueado",
    "factura_fecha": "2020-11-15T00:00:00",
    "factura_numero": 102346,
    "factura_serie": "FM",
    "fecha_documento": "2020-10-28T00:00:00",
    "fecha_servicio": "2020-10-28T00:00:00",
    "forma_pago": "1",
    "forma_pago_descripcion": "CONTADO",
    "hash": 456724,
    "id": "3b433c26-7032-11eb-82dd-54e1ade9de7d",
    "idfiscal": {
        "codigo_documento": "G98798798",
        "direccion": {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "latitud": 0.0,
            "longitud": 0.0,
            "pais": "ES",
            "poblacion": "Algemes\u00ed",
            "provincia": "Valencia",
            "tipo": "generica"
        },
        "forma_juridica": "V",
        "idfiscal_id": "05cd76fc-8236-4bfb-a5a2-dfe55647356e",
        "nombre": "Fundacion Pepe Lopez",
        "tipo_documento": "DNI"
    },
    "lineas": [
        {
            "cantidad_entrega": 1.0,
            "cantidad_pedido": 1.0,
            "cantidad_valoracion": 1.0,
            "cargo_abono_adicional": 0.0,
            "codigogrupo": 0,
            "coste_dimension1": null,
            "coste_dimension2": null,
            "coste_dimension3": {
                "clave_dimension": "P",
                "codigo": "CERV",
                "descripcion": "CERVEZA",
                "id": "94a3365a-2cd2-11ec-9784-54e1ade9de7d",
                "nivel": 1,
                "tipo_dimension": "Organizacion"
            },
            "coste_dimension4": null,
            "descripcion_modificable": "",
            "dotacion_apoyo_comercial": 0.0,
            "dotacion_comision_servicio": 0.0,
            "dotacion_contrato": 0.0,
            "dotacion_descuento_recuperable": 0.0,
            "dotacion_rappel": 0.0,
            "dotacion_referencia": "",
            "envase_codigo": "",
            "envase_id": "",
            "envase_nombre": "",
            "euros_descuento_operativo": 0.0,
            "euros_descuento_vinculado_distribuidor": 0.0,
            "euros_descuento_vinculado_proveedor": 0.0,
            "formato_codigo": "LI106",
            "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
            "formato_nombre": "BARRIL CERVEZA 30 L.",
            "importe_azucar": 0.0,
            "importe_cesion": 0.0,
            "importe_presupuesto": 0.0,
            "importe_sig": 0.0,
            "impuestoenvase": 0.0,
            "impuestoliquido": 3.0,
            "litros": 30.0,
            "lote_codigo": "",
            "lote_descripcion": "",
            "orden": 0,
            "peso_neto": 30.0,
            "precio": 30.0,
            "precio_coste": 21.0,
            "precio_envase": 0.0,
            "tarifa_codigo": "3",
            "total": 30.0,
            "totalconimpuestos": 33.0,
            "totalenvase": 0.0,
            "totalliquido": 30.0,
            "valor_azucar": 0.0,
            "valor_coeficientecarga": 1.0,
            "valor_coste": 21.0,
            "valor_flete": 0.0,
            "valor_margen": 2.0,
            "valor_sig": 0.0,
            "valorimpuesto": "10.00",
            "valorimpuestoenvase": ""
        }
    ],
    "matricula": "ABC0102",
    "numero": 820,
    "numero_pedido": "P147",
    "organizacion_venta": "GENERAL",
    "peso_bruto": 30.0,
    "proveedor": null,
    "punto_venta_codigo": "10000",
    "punto_venta_descripcion": "MUSEO DE LA FAUNA SALVAJE",
    "regimen_fiscal": "general",
    "repartidor": {
        "clave_dimension": "repartidor",
        "codigo": "RP005",
        "id": "00301270-6e90-407d-813d-b2d26fc526ac",
        "idfiscal": {
            "codigo_documento": "B98798646",
            "forma_juridica": "B",
            "idfiscal_id": "002e9612-4180-4644-aa36-72b201175emp",
            "nombre": "FRANCISCO MONTES MONTES",
            "tipo_documento": "CIF"
        },
        "nombre": "PACO MONTES",
        "subcuenta": ""
    },
    "responsable": {
        "clave_dimension": "repartidor",
        "codigo": "RP005",
        "id": "00301270-6e90-407d-813d-b2d26fc526ac",
        "idfiscal": {
            "codigo_documento": "B98798646",
            "forma_juridica": "B",
            "idfiscal_id": "002e9612-4180-4644-aa36-72b201175emp",
            "nombre": "FRANCISCO MONTES MONTES",
            "tipo_documento": "CIF"
        },
        "nombre": "PACO MONTES",
        "subcuenta": ""
    },
    "responsable_codigo": "4.V",
    "responsable_documento": {
        "clave_dimension": "repartidor",
        "codigo": "RP005",
        "id": "00301270-6e90-407d-813d-b2d26fc526ac",
        "idfiscal": {
            "codigo_documento": "B98798646",
            "forma_juridica": "B",
            "idfiscal_id": "002e9612-4180-4644-aa36-72b201175emp",
            "nombre": "FRANCISCO MONTES MONTES",
            "tipo_documento": "CIF"
        },
        "nombre": "PACO MONTES",
        "subcuenta": ""
    },
    "responsable_nombre": "RAFAEL",
    "ruta_reparto": {
        "codigo": "002",
        "descripcion": "Ruta 2",
        "responsable": null,
        "tipo": "reparto"
    },
    "serie": "20T/",
    "tipo_documento": "Factura Directa",
    "tipo_facturacion": "Factura Diaria",
    "total": 30.0,
    "total_con_impuestos": 33.0,
    "transaccion_id": "88fa2b73-7b2f-4d01-a98c-7a2ed800731f"
}
Campo Tipo Descripción
almacen_codigo string código de almacén
almacen_nombre string nombre de almacén
aplicar_flete bool true si aplicamos flete
bultos decimal numero de bultos servidos
cargar_envase string indica si hay que cargar los envases: cargar, nocargar, documento_aparte
cliente InterlocutorComercialResumen cliente de la venta
dto_pronto_pago decimal descuento de pronto pago aplicado (en porcentajes)
entrega Direccion dirección de la entrega
estado string estado de documento. Ej.: Bloqueado, Facturado
fecha_documento datetime fecha de creación/valoración de la venta
fecha_servicio datetime fecha del servicio/entrega
forma_pago string código de la forma de pago
forma_pago_descripcion string descripción de la forma de pago
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que la venta cambia.
idfiscal IdentificacionFiscal identificación fiscal de la venta
id uuid identificador de la venta
lineas [VentaLinea, ] líneas de venta
numero integer numero de documento de venta
organizacion_venta string organización de venta
proveedor InterlocutorComercialResumen proveedor de la venta en caso de servicio por cuenta de terceros (intermediación)
punto_venta_codigo string código del punto de venta
punto_venta_descripcion string descripción del punto de venta
responsable Empleado responsable estadístico de la venta
responsable_codigo string código del responsable estadístico
responsable_nombre string nombre del responsable estadístico
responsable_documento Empleado vendedor que ha hecho la venta
serie string serie de documento de venta
tipo_documento string tipo del documento Ej.: Albaran_Preventa, Factura_Directa, Factura_Rectificativa
tipo_facturacion string tipo de facturación
total_con_impuestos decimal total de la venta con impuestos
total decimal total de la venta antes de aplicar IVA
transaccion_id uuid Identificador de la transaccion para confirmar el pedido con /pedidocrm_confirmar/.
El campo solo esta disponible si la venta se ha creado con /pedidocrm_valorar/.
delegacion string clave de dimensión del centro de costes
canal string clave de dimensión del centro de costes
matricula string matricula del vehículo de reparto
repartidor Empleado empleado que reparte el documento
ruta_reparto Ruta ruta en la que se reparte el documento
peso_bruto decimal total peso del documento
factura_serie string serie de la factura si el documento esta facturado
factura_numero integer numero de la factura si el documento esta facturado
factura_fecha datetime fecha de la factura si el documento esta facturado
numero_pedido string número de pedido del que procede el albarán
regimen_fiscal string tipo de régimen fiscal: general, recargo, exento

VentaFactura

Representa una factura de venta - resumen de los albaranes. 

{
    "albaranes": [
        {
            "bultos": 1.0,
            "estado": "Bloqueado",
            "fecha_documento": "2020-10-28T00:00:00",
            "fecha_servicio": "2020-10-28T00:00:00",
            "hash": 456788,
            "id": "3b433c26-7032-11eb-36dd-54e1ade9de7d",
            "numero": 36527,
            "serie": "A",
            "tipo_documento": "Albaran Preventa",
            "total": 30.0,
            "total_con_impuestos": 33.0
        }
    ],
    "cliente": {
        "codigo": "10001",
        "hash": 0,
        "id": "71ea6353-9150-11eb-9321-54e1ade9de7d",
        "nombre": "BODEGAS ARRIATE S.L.",
        "tipo": "proveedor"
    },
    "deuda_id": "c3b23ca0-41e3-11e5-ab5f-003950c3885c",
    "direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "latitud": 0.0,
        "longitud": 0.0,
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "dto_pronto_pago": 0.0,
    "estado": "Factura cerrada",
    "fecha_documento": "2020-11-15T00:00:00",
    "forma_pago": {
        "abreviatura": "ef",
        "codigo": "contado",
        "descripcion": "Efectivo contado",
        "plazos": [],
        "tipo_documento": "Efectivo"
    },
    "id": "71ea6343-9350-11eb-9321-64e1ade7de7d",
    "idfiscal": {
        "codigo_documento": "B98798757",
        "forma_juridica": "B",
        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
        "nombre": "BODEGAS ARRIATE S.L.",
        "tipo_documento": "CIF"
    },
    "numero": 130,
    "regimen_fiscal": "general",
    "responsable": {
        "clave_dimension": "comercial",
        "codigo": "RP20",
        "id": "00301290-4a70-4a8d-823d-c2d27fc536",
        "idfiscal": {
            "codigo_documento": "G95445782",
            "direccion": {
                "codigo_postal": "46680",
                "direccion": "Calle Museo 34",
                "latitud": 0.0,
                "longitud": 0.0,
                "pais": "ES",
                "poblacion": "Algemes\u00ed",
                "provincia": "Valencia",
                "tipo": "generica"
            },
            "forma_juridica": "V",
            "idfiscal_id": "06cd76fc-8a36-4bhb-a7a2-dfe59648352e",
            "nombre": "Alfonso",
            "tipo_documento": "DNI"
        },
        "nombre": "Alfonso"
    },
    "serie": "FM",
    "tipo_facturacion": "Factura Mensual",
    "total": 30.0,
    "total_con_impuestos": 33.0
}
Campo Tipo Descripción
id uuid identificador de la venta
serie string serie de documento de venta
numero integer numero de documento de venta
idfiscal IdentificacionFiscal identificación fiscal de la venta
cliente InterlocutorComercialResumen cliente de la venta
direccion Direccion dirección fiscal
albaranes [VentaResumen] lista de albaranes incluidos en la factura
estado string estado de documento. Ej.: Factura cerrada
fecha_documento datetime fecha de creación/valoración de la venta
forma_pago FormaPago forma de pago
regimen_fiscal string tipo de régimen fiscal: general, recargo, exento
responsable Empleado responsable estadístico de la venta
tipo_facturacion string tipo de facturación
dto_pronto_pago decimal descuento de pronto pago aplicado (en porcentajes)
total decimal total de la venta antes de aplicar IVA
total_con_impuestos decimal total de la venta con impuestos
deuda_id uuid identificador de la deuda asociada a la venta

VentaLinea

Representa una linea de venta 

{
    "cantidad_entrega": 1.0,
    "cantidad_pedido": 1.0,
    "cantidad_valoracion": 1.0,
    "cargo_abono_adicional": 0.0,
    "codigogrupo": 0,
    "coste_dimension1": null,
    "coste_dimension2": null,
    "coste_dimension3": {
        "clave_dimension": "P",
        "codigo": "CERV",
        "descripcion": "CERVEZA",
        "id": "94a3365a-2cd2-11ec-9784-54e1ade9de7d",
        "nivel": 1,
        "tipo_dimension": "Organizacion"
    },
    "coste_dimension4": null,
    "descripcion_modificable": "",
    "dotacion_apoyo_comercial": 0.0,
    "dotacion_comision_servicio": 0.0,
    "dotacion_contrato": 0.0,
    "dotacion_descuento_recuperable": 0.0,
    "dotacion_rappel": 0.0,
    "dotacion_referencia": "",
    "envase_codigo": "",
    "envase_id": "",
    "envase_nombre": "",
    "euros_descuento_operativo": 0.0,
    "euros_descuento_vinculado_distribuidor": 0.0,
    "euros_descuento_vinculado_proveedor": 0.0,
    "formato_codigo": "LI106",
    "formato_id": "fc0e5e6d-4ad6-4ebc-a2ea-da2ff30d3107",
    "formato_nombre": "BARRIL CERVEZA 30 L.",
    "importe_azucar": 0.0,
    "importe_cesion": 0.0,
    "importe_presupuesto": 0.0,
    "importe_sig": 0.0,
    "impuestoenvase": 0.0,
    "impuestoliquido": 3.0,
    "litros": 30.0,
    "lote_codigo": "",
    "lote_descripcion": "",
    "orden": 0,
    "peso_neto": 30.0,
    "precio": 30.0,
    "precio_coste": 21.0,
    "precio_envase": 0.0,
    "tarifa_codigo": "3",
    "total": 30.0,
    "totalconimpuestos": 33.0,
    "totalenvase": 0.0,
    "totalliquido": 30.0,
    "valor_azucar": 0.0,
    "valor_coeficientecarga": 1.0,
    "valor_coste": 21.0,
    "valor_flete": 0.0,
    "valor_margen": 2.0,
    "valor_sig": 0.0,
    "valorimpuesto": "10.00",
    "valorimpuestoenvase": ""
}
Campo Tipo Descripción
cantidad_entrega decimal cantidad de mercancía entregada
cantidad_pedido decimal cantidad de mercancía pedida (cantidad original del pedido)
cantidad_valoracion decimal cantidad de mercancía para valorar la línea. Normalmente coincide con cantidad entregada, pero indica peso en los artículos de peso
cargo_abono_adicional decimal cargos adicionales como flete
codigogrupo integer identificador de grupo de las lineas, para imprimir ciertas lineas juntas
descripcion_modificable string descripción de la línea alternativa
dotacion_apoyo_comercial decimal apoyo proveedor fuera factura compra
dotacion_comision_servicio decimal comision de servicios terceros/intermediaciones
dotacion_contrato decimal dotacion contratos fabricantes con clientes comprados
dotacion_descuento_recuperable decimal Descuento a liquidar con el proveedor
dotacion_rappel decimal Descuento diferido o rapel a cliente
dotacion_referencia string Numero de referencia del contrato de rapel
envase_codigo string código de envase
envase_id uuid id del formato del envase asociado o vacío si el envase no es aplicable
envase_nombre string nombre de envase
euros_descuento_operativo decimal total descuento aplicado sobre la linea
euros_descuento_vinculado_distribuidor decimal total descuento aplicado al distribuidor
euros_descuento_vinculado_proveedor decimal total descuento aplicado al proveedor
formato_codigo string código de formato
formato_id uuid id del formato
formato_nombre string nombre de formato
importe_azucar decimal importe total de impuesto de bebidas azucaradas
importe_cesion decimal importe total de la cesion del gasto abonada por el proveedor
importe_presupuesto decimal objetivo en importe
importe_sig decimal importe total del SIG (punto verde)
impuestoenvase decimal total cuotas de IVA aplicadas sobre envase asociado
impuestoliquido decimal total cuotas de IVA aplicadas sobre liquido
lote_codigo string código de lote de los artículos, si la linea es parte de un lote
lote_descripcion string descripción de lote de los artículos, si la linea es parte de un lote
orden integer orden de las lineas
precio_coste decimal precio de coste
precio_envase decimal precio de envase asociado
precio decimal precio aplicado sobre la línea
tarifa_codigo string código de tarifa aplicado
totalconimpuestos decimal total de la linea incluyendo los impuestos
totalenvase decimal total del envase asociado
totalliquido decimal total del liquido
total decimal total de la linea
valor_azucar decimal tasa de impuesto de bebidas
valor_coeficientecarga decimal coeficiente de carga
valor_coste decimal precio de coste medio
valor_margen decimal margen unitario
valor_flete decimal tasa de flete
valor_sig decimal tasa de SIG (punto verde)
valorimpuestoenvase string una representación de porcentaje de IVA aplicado a envase, ej.: 10
valorimpuesto string una representación de porcentaje de IIVA aplicado a liquido, vacío si hay varios impuestos aplicados
coste_dimension1 CentroCoste coste dimensión nivel 1
coste_dimension2 CentroCoste coste dimensión nivel 2
coste_dimension3 CentroCoste coste dimensión nivel 3
coste_dimension4 CentroCoste coste dimensión nivel 4
peso_neto decimal indica peso neto de la linea (peso del producto por cantidad)
litros decimal indica litros de la linea (litros de producto por cantidad)

VentaResumen

Representa un resumen del documento de venta. 

{
    "bultos": 1.0,
    "estado": "Bloqueado",
    "fecha_documento": "2020-10-28T00:00:00",
    "fecha_servicio": "2020-10-28T00:00:00",
    "hash": 456724,
    "id": "3b433c26-7032-11eb-82dd-54e1ade9de7d",
    "numero": 820,
    "serie": "20T/",
    "tipo_documento": "Factura Directa",
    "total": 30.0,
    "total_con_impuestos": 33.0
}
Campo Tipo Descripción
bultos decimal numero de bultos servidos
estado string estado de documento. Ej.: Bloqueado, Facturado
fecha_documento datetime fecha de creación/valoración de la venta
fecha_servicio datetime fecha del servicio/entrega
hash integer valor de hash para identificar la versión del registro. Este valor cambia cada vez que la venta cambia.
id uuid identificador de la venta
numero integer numero de documento de venta
serie string serie de documento de venta
tipo_documento string tipo del documento Ej.: Albaran Preventa, Factura Directa, Factura Rectificativa
total_con_impuestos decimal total de la venta con impuestos
total decimal total de la venta antes de aplicar IVA