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:

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,
    "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

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": "",
    "fabricante_codigo": "24",
    "fabricante_descripcion": "San Miguel",
    "formatos": [
        {
            "baja": false,
            "codigo": "1045-24",
            "descripcion": "San Miguel 1/3 24x",
            "equivalencia": 24.0,
            "etiquetas": [
                "nacional",
                "tercio"
            ],
            "id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
            "litros": 0.33,
            "nombre": "San Miguel 1/3 Caja 24 botellas",
            "peso": 9.6,
            "peso_neto": 7.2,
            "peso_por_defecto": 0.0,
            "tasas": [
                {
                    "tipo": "SIG",
                    "valor": 0.05
                }
            ],
            "tipo": "caja",
            "volumen": 0.0072
        },
        {
            "baja": false,
            "codigo": "1045-1",
            "descripcion": "San Miguel 1/3",
            "equivalencia": 1.0,
            "id": "3b3ab89d-427f-7563-9863-87644d89e8bd",
            "litros": 0.33,
            "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",
            "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",
    "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
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
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 artículos
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

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.

Asiento

Representa un asiento contable

{
    "apuntes": [
        {
            "Debe": 1210.0,
            "Descripcion": "F20001",
            "Haber": 0.0,
            "Numero": 1,
            "Subcuenta": "4300000321"
        },
        {
            "Debe": 0.0,
            "Descripcion": "N/FRA F20001",
            "Haber": 1210.0,
            "Numero": 2,
            "Subcuenta": "6000000001"
        }
    ],
    "descripcion": "ASIENTO FACTURA",
    "ejercicio": 2020,
    "fecha": "2020-05-30T00:00:00",
    "numero": 100,
    "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",
            "idfiscal": {
                "codigo_documento": "B98798757",
                "forma_juridica": "B",
                "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
                "nombre": "GRUPO HOSTELEROS S.L.",
                "tipo_documento": "CIF"
            },
            "numero_recepcion": 0,
            "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
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.

Contacto

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

{
    "cargo": "Director",
    "email": "pepe@faunamuseo.com",
    "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",
    "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
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

Diario

Representa un diario contable

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",
    "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

Formato

Representa un formato del artículo.

{
    "baja": false,
    "codigo": "1045-24",
    "descripcion": "San Miguel 1/3 24x",
    "equivalencia": 24.0,
    "etiquetas": [
        "nacional",
        "tercio"
    ],
    "id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c",
    "litros": 0.33,
    "nombre": "San Miguel 1/3 Caja 24 botellas",
    "peso": 9.6,
    "peso_neto": 7.2,
    "peso_por_defecto": 0.0,
    "tasas": [
        {
            "tipo": "SIG",
            "valor": 0.05
        }
    ],
    "tipo": "caja",
    "volumen": 0.0072
}
Campo Tipo Descripción
id uuid identificador del formato
tipo string tipo de formato: unidad o caja
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 [string, ] lista de etiquetas asociadas con el formato
unidad_medida string nombre de la unidad de medida de formato ej. unidad, caja, paquete, botella etc.

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",
        "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

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

InterlocutorComercial

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

{
    "baja": false,
    "cargar_envases": "documentoaparte",
    "codigo": "10000",
    "codigo_barras": "",
    "contactos": [
        {
            "cargo": "Director",
            "email": "pepe@faunamuseo.com",
            "fax": "",
            "fijo": "+34123123123",
            "movil": "+34321321321",
            "nombre": "Pepe Lopez"
        }
    ],
    "direcciones": [
        {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "pais": "ES",
            "poblacion": "Algemes\u00ed",
            "provincia": "Valencia",
            "tipo": "generica"
        }
    ],
    "documento_entrega": "factura",
    "email_facturacion": "info@faunamuseo.com",
    "exento_sig": false,
    "forma_pago": "contado",
    "hash": 4153754459,
    "id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
    "idfiscal": {
        "codigo_documento": "G98798798",
        "direccion": {
            "codigo_postal": "46680",
            "direccion": "Calle Museo 34",
            "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",
    "subcuenta": "430010000",
    "tarifa": "D",
    "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
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)
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
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
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.

InterlocutorComercialResumen

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

{
    "codigo": "10000",
    "hash": 4153754459,
    "id": "3d61abd3-d01d-42d8-ab39-50ff691d044c",
    "nombre": "MUSEO DE LA FAUNA SALVAJE",
    "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.

Pedido

Representa un pedido para grabar en winfra.

{
    "cliente_direccion": {
        "codigo_postal": "46680",
        "direccion": "Calle Museo 34",
        "pais": "ES",
        "poblacion": "Algemes\u00ed",
        "provincia": "Valencia",
        "tipo": "generica"
    },
    "cliente_nombre": "Pepe Lopez",
    "comentario": "Entregar por la ma\u00f1ana",
    "email": "pepe@faunamuseo.com",
    "identicket": "",
    "identificador": "",
    "lineas": [
        {
            "cantidad": 2.0,
            "formato_codigo": "",
            "formato_id": "3b3ab89d-427f-4a79-9863-2060ef5c9d0c"
        }
    ],
    "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

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_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"
        }
    ]
}
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

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.

PedidoConfirmacion

Los datos necesarios para confirmar pedido subido a winfra.

{
    "codigo_autorizacion": "003555",
    "codigo_orden": "1590751280",
    "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.
codigo_autorizacion string código de autorización de pago
codigo_orden string código de orden de pago

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,
    "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 el formato_codigo
formato_codigo string código del formato del artículo. Este campo es opcional.
cantidad decimal la cantidad vendida

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"
}
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

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",
    "idfiscal": {
        "codigo_documento": "B98798757",
        "forma_juridica": "B",
        "idfiscal_id": "002e9612-4180-4644-aa36-72b201175cea",
        "nombre": "GRUPO HOSTELEROS S.L.",
        "tipo_documento": "CIF"
    },
    "numero_recepcion": 0,
    "tipo": "Expedidas",
    "tipo_iva": "Repercutido"
}
Campo Tipo Descripción
idfiscal IdentificacionFiscalResumen identicación fiscal resumida
fecha datetime fecha del registro
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

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.

{
    "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

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
}
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