Esquemas de datos
Dirección de entrega
AddressData · Esquema · Esquemas de datos: Pedidos
address_line_1Cadena de texto nullObligatorioPrimera línea de dirección.
address_line_2Cadena de texto nullObligatorioInformación adicional de la dirección.
cityCadena de texto nullObligatorioCiudad o localidad.
country_codeCadena de texto nullObligatorioCódigo del país.
first_nameCadena de texto nullObligatorioNombre.
house_numberCadena de texto nullObligatorioNúmero del edificio o de la vivienda.
last_nameCadena de texto nullObligatorioApellidos.
phoneCadena de texto nullObligatorioNúmero de teléfono.
postal_codeCadena de texto nullObligatorioCódigo postal.
regionCadena de texto nullObligatorioRegión administrativa.
streetCadena de texto nullObligatorioNombre de la calle.
Campos adicionales: No
ApiResponse_OrderFileListData_
ApiResponse_OrderFileListData_ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
dataOrderFileListDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
ApiResponse_OrderReleaseListData_
ApiResponse_OrderReleaseListData_ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
dataOrderReleaseListDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
Listar — Pedidos — Respuesta
ApiResponse_list_OrderSummaryData__ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
dataLista <OrderSummaryData> ObligatorioEjemplo de respuesta · ApiResponse_list_OrderSummaryData__.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
Obtener — Pedidos — Respuesta
ApiResponse_OrderDetailData_ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
dataOrderDetailDataObligatorioEjemplo de respuesta · OrderDetailData.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
CurrentReleaseData
CurrentReleaseData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
acquiredBooleanoObligatorioAcceso después de la compra (true / false)
changelogCadena de textoObligatorioDescripción de los cambios
covered_by_purchaseBooleanoObligatorioAcceso después de la compra (true / false)
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
published_atCadena de textoObligatorioPublicar versión · UTC
format:"date-time"requires_new_purchaseBooleanoObligatorioSin acceso a archivos añadidos después de la compra · requires_new_purchase
sequenceNúmero enteroObligatorioPosición en la colección ordenada.
version_labelCadena de textoObligatorioVersión
Campos adicionales: No
Información del cliente registrada para este recurso
CustomerData · Esquema · Esquemas de datos: Pedidos
emailCadena de textoObligatorioDirección de correo electrónico.
first_nameCadena de texto nullObligatorioNombre.
last_nameCadena de texto nullObligatorioApellidos.
phoneCadena de texto nullObligatorioNúmero de teléfono.
Campos adicionales: No
DeliveryContentDeletion
DeliveryContentDeletion · Elimina el contenido definitivamente y conserva el historial. El código no vuelve a estar a la venta.
expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500
Campos adicionales: No
Fechas de envío y entrega
DeliveryDatesData · La lista y el detalle de pedidos incluyen delivery.dates. Las fechas YYYY-MM-DD son previstas y no confirman el envío. Las fechas actuales tienen prioridad; los pedidos antiguos usan la estimación guardada. Los valores borrados o desconocidos son null. El detalle también incluye todas las líneas e imágenes de productos.
dispatch_timezoneCadena de texto nullObligatorioZona horaria del envío (IANA; null).
estimated_delivery_fromCadena de texto nullObligatorioInicio de la entrega estimada (YYYY-MM-DD; null).
Cadena de texto:format:"date"estimated_delivery_toCadena de texto nullObligatorioFin de la entrega estimada (YYYY-MM-DD; null).
Cadena de texto:format:"date"planned_dispatch_onCadena de texto nullObligatorioFecha prevista de envío (YYYY-MM-DD; null).
Cadena de texto:format:"date"
Campos adicionales: No
DeliveryReplacement
DeliveryReplacement · Elige una unidad libre existente como reemplazo. El plazo de conservación no empieza de nuevo.
expected_unit_versionNúmero enteroObligatorioVersión actual de la unidad libre de reemplazo.
minimum:1expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500replacement_unit_idCadena de textoObligatorioID de una unidad libre existente para reemplazo.
format:"uuid"
Campos adicionales: No
DeliveryPickupPointData
DeliveryPickupPointData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
addressPickupPointAddressDataObligatorioDirección de entrega.
codeCadena de textoObligatorioCódigo estable legible por programas.
Restricciones
pattern"^[A-Za-z0-9_-]{1,63}$"
coordinatesPickupPointCoordinatesDatanullObligatorioValor definido por el esquema que lo contiene.
country_codeCadena de textoObligatorioCódigo del país.
Restricciones
pattern"^[A-Z]{2}$"
environmentCadena de textoObligatorioInformación del entorno asociada al registro.
Restricciones
enum["live", "sandbox"]
kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["locker", "pickup_point"]
location_descriptionCadena de texto nullObligatorioDescripción en el idioma seleccionado.
Cadena de texto:maxLength:1000nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
minLength:1maxLength:160opening_hoursCadena de texto nullObligatorioOpening hours
Cadena de texto:maxLength:500operatorCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
minLength:1maxLength:63verified_atCadena de textoObligatorioMomento de la última actualización.
format:"date-time"
Campos adicionales: No
ApiResponse[list[DeliveryData]]
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_DeliveryData____1 · Lista las unidades asignadas sin revelar códigos. Un reembolso retira el acceso solo a las líneas afectadas.
dataLista <shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData> ObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
DeliveryData
shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData · Lista las unidades asignadas sin revelar códigos. Un reembolso retira el acceso solo a las líneas afectadas.
can_downloadBooleanoObligatorioDescargar (true / false)
content_stateCadena de textoObligatorioEstado del contenido: present / deleting / deleted.
delete_due_atCadena de texto nullObligatorioBorrado programado del archivo; null lo desactiva.
Cadena de texto:format:"date-time"filenameCadena de texto nullObligatorioArchivo
first_available_atCadena de texto nullObligatorioPrimer acceso de esta compra; el reemplazo no reinicia el plazo.
Cadena de texto:format:"date-time"generationNúmero enteroObligatorioGeneración de la asignación; aumenta al sustituirla.
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
format:"uuid"kindCadena de texto nullObligatorioVariante de la estructura de datos definida por los valores admitidos.
line_idCadena de textoObligatorioIdentificador estable de la línea del pedido.
order_idCadena de textoObligatorioIdentificador del pedido relacionado.
payload_idCadena de textoObligatorioID del contenido; no es una URL pública de descarga.
format:"uuid"product_idCadena de textoObligatorioIdentificador del producto.
reasonCadena de textoObligatorioMotivo registrado para el cambio.
size_bytesNúmero entero nullObligatorioTamaño en bytes
stateCadena de textoObligatorioEstado
unit_idCadena de textoObligatorioID de un código o archivo individual.
format:"uuid"unit_ordinalNúmero enteroObligatorioNúmero de unidad comprada dentro de la línea del pedido.
variant_idCadena de texto nullObligatorioIdentificador de la variante del producto.
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Información de la factura
InvoiceData · Esquema · Esquemas de datos: Pedidos
address_line_1Cadena de texto nullObligatorioPrimera línea de dirección.
address_line_2Cadena de texto nullObligatorioInformación adicional de la dirección.
cityCadena de texto nullObligatorioCiudad o localidad.
company_nameCadena de texto nullObligatorioNombre de la empresa.
country_codeCadena de texto nullObligatorioCódigo del país.
house_numberCadena de texto nullObligatorioNúmero del edificio o de la vivienda.
postal_codeCadena de texto nullObligatorioCódigo postal.
regionCadena de texto nullObligatorioRegión administrativa.
streetCadena de texto nullObligatorioNombre de la calle.
tax_identifierCadena de texto nullObligatorioNúmero de identificación fiscal.
tax_schemeCadena de texto nullObligatorioEsquema de cálculo de impuestos.
Campos adicionales: No
Importe neto / Importe del impuesto / Importe bruto
OrderAmountBreakdownData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
grossMoneyDataObligatorioImporte bruto · Después de descuentos; Desconocido: null; cero conocido: 0.
netMoneyDatanullObligatorioImporte neto · Después de descuentos; Desconocido: null; cero conocido: 0.
taxMoneyDatanullObligatorioImporte del impuesto · Después de descuentos; Desconocido: null; cero conocido: 0.
Campos adicionales: No
Envío · Descuentos
OrderDeliveryDiscountData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
amountMoneyDataObligatorioImporte bruto · Envío · Descuentos.
campaign_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
codeCadena de texto nullObligatorioCódigo estable legible por programas.
kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["coupon", "promotion"]
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
sequenceNúmero entero nullObligatorioPosición en la colección ordenada.
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Obtener — Pedidos — Respuesta
OrderDetailData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
created_atCadena de textoObligatorioMomento de creación.
format:"date-time"customerCustomerDataObligatorioInformación del cliente registrada para este recurso.
deliveryShippingDetailDataObligatorioMétodo de entrega e información asociada.
discount_amountMoneyDataObligatorioImporte decimal codificado como cadena JSON; null solo cuando se permite.
discountsLista <OrderDiscountData> ObligatorioDescuentos
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (OrderDetailData).
invoiceInvoiceDatanullObligatorioInformación de la factura.
invoice_requestedBooleanoObligatorioIndica si se solicitó una factura.
lifecycle_stateOrderLifecycleStateObligatorioEstado del ciclo de vida del recurso.
linesLista <OrderLineData> ObligatorioDatos de las líneas de pedido conservados al registrarlo.
localeCadena de textoObligatorioIdioma seleccionado para esta solicitud.
market_idCadena de textoObligatorioIdentificador del mercado devuelto por el endpoint de contexto.
numberCadena de textoObligatorioNúmero de pedido o solicitud mostrado al usuario.
paymentPaymentDataObligatorioDetalles del pago registrados en el pedido.
pickup_pointPickupPointDatanullObligatorioPunto de recogida
prices_include_taxBooleanoObligatorioIndica si los precios de la lista incluyen impuestos.
shipping_addressAddressDatanullObligatorioDirección de entrega.
shipping_discount_amountMoneyDataObligatorioImporte decimal codificado como cadena JSON; null solo cuando se permite.
statusOrderStatusDataObligatorioEstado admitido por esta operación concreta.
subtotalMoneyDataObligatorioImporte anterior a los componentes adicionales indicados en la respuesta.
taxMoneyDataObligatorioInformación fiscal.
tax_breakdownOrderTaxBreakdownDataObligatorioGrupos fiscales · source + tax_rate; unallocated_tax.
tax_country_codeCadena de texto nullObligatorioPaís fiscal · Datos guardados del pedido · ISO 3166-1 alpha-2; null.
totalMoneyDataObligatorioImporte total.
totalsOrderTotalsDataObligatorioTotales · net / tax / gross; Antes de descuentos / Después de descuentos.
Campos adicionales: No
OrderFileData
OrderFileData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
can_downloadBooleanoObligatorioDescargar (true / false)
categoryFileCategoryObligatorioCategoría del archivo: internal / customer_document / digital
filenameCadena de textoObligatorioArchivo
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
labelCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
line_idCadena de textoObligatorioIdentificador estable de la línea del pedido.
mime_typeCadena de textoObligatorioTipo de contenido multimedia.
product_idCadena de textoObligatorioIdentificador del producto.
purchase_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. · purchase_id
reasonCadena de textoObligatorioMotivo registrado para el cambio.
sha256Cadena de textoObligatorioSHA-256 (hex, 64)
size_bytesNúmero enteroObligatorioTamaño en bytes
minimum:1maximum:262144000source_file_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. · source_file_id
source_version_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. · source_version_id
source_version_numberNúmero enteroObligatorioVersión
minimum:1stateCadena de textoObligatorioEstado
Campos adicionales: No
OrderFileListData
OrderFileListData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
filesLista <OrderFileData> ObligatorioArchivos del producto
updates_pendingBooleanoObligatorioAcceso a futuros archivos después de la compra · updates_pending
Campos adicionales: No
Metadatos y URL de la imagen
OrderImageData · Esquema · Esquemas de datos: Pedidos
altCadena de texto nullObligatorioTexto alternativo de una imagen.
sourceCadena de textoOpcionalOrigen de la actividad registrada.
const:"current_catalog"urlCadena de textoObligatorioURL del recurso.
Campos adicionales: No
Estado del ciclo de vida del recurso
OrderLifecycleState · Esquema · Esquemas de datos: Pedidos
Cadena de textoRestricciones
enum["placed", "cancelled", "fulfilled", "returned"]
Campos adicionales: Sí
Datos de las líneas de pedido conservados al registrarlo
OrderLineData · Esquema · Esquemas de datos: Pedidos
discount_amountMoneyDataObligatorioImporte decimal codificado como cadena JSON; null solo cuando se permite.
discount_grossMoneyDataObligatorioImporte bruto · Descuentos; Desconocido: null; cero conocido: 0.
discount_netMoneyDatanullObligatorioImporte neto · Descuentos; Desconocido: null; cero conocido: 0.
discount_taxMoneyDatanullObligatorioImporte del impuesto · Descuentos; Desconocido: null; cero conocido: 0.
discountsLista <OrderDiscountData> ObligatorioDescuentos · net / tax / gross.
identifiersObjetoCampos adicionales: Cadena de textoObligatorioCódigos de identificación del producto.
imageOrderImageDatanullObligatorioMetadatos y URL de la imagen.
line_idCadena de textoObligatorioIdentificador estable de la línea del pedido.
manual_discountOrderManualDiscountDatanullObligatorioDescuento manual; null.
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
original_totalMoneyDataObligatorioImporte total.
original_total_grossMoneyDataObligatorioImporte bruto · Productos · Antes de descuentos; Desconocido: null; cero conocido: 0.
original_total_netMoneyDatanullObligatorioImporte neto · Productos · Antes de descuentos; Desconocido: null; cero conocido: 0.
original_total_taxMoneyDatanullObligatorioImporte del impuesto · Productos · Antes de descuentos; Desconocido: null; cero conocido: 0.
positionNúmero enteroObligatorioPosición en la colección ordenada.
product_idCadena de textoObligatorioIdentificador del producto.
quantityNúmero enteroObligatorioNúmero de unidades.
skuCadena de textoObligatorioCódigo de referencia de inventario.
taxMoneyDatanullObligatorioImporte del impuesto · Una unidad · Datos guardados del pedido; tax ≠ unit_tax; Desconocido: null; cero conocido: 0.
tax_category_idCadena de texto nullObligatorioIdentificador de categoría fiscal · Datos guardados del pedido; null.
tax_category_nameCadena de texto nullObligatorioNombre guardado de la categoría fiscal; null.
tax_rateCadena de texto nullObligatoriotax_rate · Datos guardados del pedido: "0.23" = 23%; "0" ≠ null.
totalMoneyDataObligatorioImporte total.
total_grossMoneyDataObligatorioImporte bruto · Productos · Después de descuentos; Desconocido: null; cero conocido: 0.
total_netMoneyDatanullObligatorioImporte neto · Productos · Después de descuentos; Desconocido: null; cero conocido: 0.
total_taxMoneyDatanullObligatorioImporte del impuesto · Productos · Después de descuentos · Datos guardados del pedido; Desconocido: null; cero conocido: 0.
unit_grossMoneyDataObligatorioImporte bruto · Una unidad · Antes de descuentos; Desconocido: null; cero conocido: 0.
unit_netMoneyDatanullObligatorioImporte neto · Una unidad · Antes de descuentos; Desconocido: null; cero conocido: 0.
unit_priceMoneyDataObligatorioPrecio por unidad.
unit_taxMoneyDatanullObligatorioImporte del impuesto · Una unidad · Antes de descuentos; Desconocido: null; cero conocido: 0.
variant_idCadena de texto nullObligatorioIdentificador de la variante del producto.
variant_optionsLista <shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData> ObligatorioOpciones de variante asociadas al producto o a sus datos registrados.
Campos adicionales: No
Descuento manual
OrderManualDiscountData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
amountMoneyDataObligatorioImporte bruto · Descuento manual · Datos guardados del pedido.
kindCadena de textoObligatorioTipo de descuento: percentage / fixed.
Restricciones
enum["percentage", "fixed"]
valueCadena de textoObligatorioValor configurado: percentage "10" = 10%; fixed = Importe bruto.
Campos adicionales: No
Estado admitido por esta operación concreta
OrderPaymentStatus · Esquema · Esquemas de datos: Pedidos
Cadena de textoRestricciones
enum["unpaid", "paid", "failed", "refunded"]
Campos adicionales: Sí
OrderReleaseData
OrderReleaseData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
access_reasonCadena de textoObligatorioAcceso después de la compra · Motivo registrado para el cambio.
access_stateCadena de textoObligatorioAcceso después de la compra · Estado
current_releaseCurrentReleaseDatanullObligatorioVersiones digitales · current_release
grant_reasonCadena de textoObligatorioAcceso después de la compra · Motivo registrado para el cambio.
granted_atCadena de textoObligatorioAcceso después de la compra · UTC
format:"date-time"idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
line_idCadena de textoObligatorioIdentificador estable de la línea del pedido.
manifest_sha256Cadena de textoObligatorioVersiones digitales · SHA-256
product_idCadena de textoObligatorioIdentificador del producto.
published_atCadena de textoObligatorioPublicar versión · UTC
format:"date-time"purchase_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. · purchase_id
release_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. · release_id
release_sequenceNúmero enteroObligatorioVersiones digitales · Posición en la colección ordenada.
update_daysNúmero entero nullObligatorioNúmero de días (days; null)
update_modeCadena de textoObligatorioAcceso a futuros archivos después de la compra: none / period / unlimited
update_monthsNúmero entero nullObligatorioMeses (months; null)
updates_untilCadena de texto nullObligatorioAcceso a futuros archivos después de la compra · UTC
Cadena de texto:format:"date-time"version_labelCadena de textoObligatorioVersión
Campos adicionales: No
OrderReleaseListData
OrderReleaseListData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API. Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Para mode=period elige days (1–3650) o el valor anterior months, nunca ambos. Las condiciones se guardan al comprar; el reembolso revoca el acceso solo a la línea reembolsada.
releasesLista <OrderReleaseData> ObligatorioVersiones digitales
updates_pendingBooleanoObligatorioAcceso a futuros archivos después de la compra · updates_pending
Campos adicionales: No
Estado admitido por esta operación concreta
OrderStatusData · Esquema · Esquemas de datos: Pedidos
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (OrderStatusData).
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
updated_atCadena de textoObligatorioMomento de la última actualización.
format:"date-time"versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Listar · Estados — Pedidos — Respuesta
shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
created_atCadena de textoObligatorioMomento de creación.
format:"date-time"idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData).
is_initialBooleanoObligatorioIndica si este es el estado inicial.
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
positionNúmero enteroObligatorioPosición en la colección ordenada.
Campos adicionales: No
Listar · Estados — Pedidos — Respuesta
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1 · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
dataLista <shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData> ObligatorioEjemplo de respuesta · shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
Actualizar · Estado — Pedidos — Cuerpo de la solicitud
OrderStatusUpdate · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1maximum:9223372036854775807status_idCadena de textoObligatorioIdentificador obtenido del catálogo de estados correspondiente.
Restricciones
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
Campos adicionales: No
Listar — Pedidos — Respuesta
OrderSummaryData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
created_atCadena de textoObligatorioMomento de creación.
format:"date-time"customerCustomerDataObligatorioInformación del cliente registrada para este recurso.
deliveryShippingDataObligatorioMétodo de entrega e información asociada.
discount_amountMoneyDataObligatorioImporte decimal codificado como cadena JSON; null solo cuando se permite.
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (OrderSummaryData).
lifecycle_stateOrderLifecycleStateObligatorioEstado del ciclo de vida del recurso.
localeCadena de textoObligatorioIdioma seleccionado para esta solicitud.
market_idCadena de textoObligatorioIdentificador del mercado devuelto por el endpoint de contexto.
numberCadena de textoObligatorioNúmero de pedido o solicitud mostrado al usuario.
paymentPaymentDataObligatorioDetalles del pago registrados en el pedido.
prices_include_taxBooleanoObligatorioIndica si los precios de la lista incluyen impuestos.
shipping_discount_amountMoneyDataObligatorioImporte decimal codificado como cadena JSON; null solo cuando se permite.
statusOrderStatusDataObligatorioEstado admitido por esta operación concreta.
subtotalMoneyDataObligatorioImporte anterior a los componentes adicionales indicados en la respuesta.
taxMoneyDataObligatorioInformación fiscal.
tax_country_codeCadena de texto nullObligatorioPaís fiscal · Datos guardados del pedido · ISO 3166-1 alpha-2; null.
totalMoneyDataObligatorioImporte total.
Campos adicionales: No
Pedido · Grupos fiscales
OrderTaxBreakdownData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
groupsLista <OrderTaxGroupData> ObligatorioGrupos fiscales · source + tax_rate; Desconocido: null; cero conocido: 0.
unallocated_taxMoneyDataObligatorioImpuesto sin asignar = order.tax − Σ groups.tax; ±.
Campos adicionales: No
Grupos fiscales
OrderTaxGroupData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
grossMoneyDataObligatorioImporte bruto · Después de descuentos; Desconocido: null; cero conocido: 0.
netMoneyDatanullObligatorioImporte neto · Después de descuentos; Desconocido: null; cero conocido: 0.
sourceCadena de textoObligatorioOrigen: products (Productos), shipping (Envío).
Restricciones
enum["products", "shipping"]
taxMoneyDatanullObligatorioImporte del impuesto · Después de descuentos; Desconocido: null; cero conocido: 0.
tax_rateCadena de texto nullObligatoriotax_rate · Datos guardados del pedido: "0.23" = 23%; "0" ≠ null.
Campos adicionales: No
Pedido · Totales
OrderTotalsData · Los importes y tipos impositivos proceden del pedido guardado, incluidas las correcciones de líneas. Los datos históricos ausentes son null y no se sustituyen por los tipos actuales del catálogo. Los importes siguen siendo cadenas decimales.
before_discountsOrderAmountBreakdownDataObligatorioPedido · Antes de descuentos · net / tax / gross.
discountsOrderAmountBreakdownDataObligatorioDescuentos · net / tax / gross.
orderOrderAmountBreakdownDataObligatorioPedido · Después de descuentos · net / tax / gross.
product_discountsOrderAmountBreakdownDataObligatorioProductos · Descuentos · net / tax / gross.
productsOrderAmountBreakdownDataObligatorioProductos · Después de descuentos · net / tax / gross.
products_before_discountsOrderAmountBreakdownDataObligatorioProductos · Antes de descuentos · net / tax / gross.
shippingOrderAmountBreakdownDataObligatorioEnvío · Después de descuentos · net / tax / gross.
shipping_before_discountsOrderAmountBreakdownDataObligatorioEnvío · Antes de descuentos · net / tax / gross.
shipping_discountsOrderAmountBreakdownDataObligatorioEnvío · Descuentos · net / tax / gross.
Campos adicionales: No
Opciones de variante asociadas al producto o a sus datos registrados
shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData · Esquema · Esquemas de datos: Pedidos
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
valueCadena de textoObligatorioValor definido por el esquema que lo contiene.
Campos adicionales: No
OrderDiscountData
OrderDiscountData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
amountMoneyDataObligatorioImporte bruto · Productos · Descuentos.
campaign_idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
codeCadena de texto nullObligatorioCódigo estable legible por programas.
kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["coupon", "promotion"]
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
sequenceNúmero entero nullOpcionalOrden de aplicación; null.
shipping_amountMoneyDatanullOpcionalImporte bruto · Envío · Descuentos; null.
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Detalles del pago registrados en el pedido
PaymentData · Esquema · Esquemas de datos: Pedidos
amountMoneyDataObligatoriopayment.amount es el total del pedido. El estado del pago no determina importes pagados, reembolsados ni pendientes.
environmentCadena de textoObligatorioInformación del entorno asociada al registro.
Restricciones
enum["live", "sandbox"]
method_codeCadena de texto nullObligatorioCódigo del método de entrega o pago.
method_nameCadena de texto nullObligatorioNombre del método de entrega o pago.
paid_atCadena de texto nullObligatorioFecha y hora en que el pago se marcó como pagado.
Cadena de texto:format:"date-time"statusOrderPaymentStatusObligatorioEstado admitido por esta operación concreta.
updated_atCadena de textoObligatorioMomento de la última actualización.
format:"date-time"versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Actualizar · Estado del pago — Pedidos — Cuerpo de la solicitud
PaymentStatusUpdate · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:0maximum:9223372036854775807reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500statusPaymentStatusObligatorioEstado admitido por esta operación concreta. unpaid: sin pagar; paid: pagado; failed: pago fallido; refunded: reembolsado.
Campos adicionales: No
Estado admitido por esta operación concreta
PaymentStatus · Esquema · Esquemas de datos: Pedidos
Cadena de textoRestricciones
enum["unpaid", "paid", "failed", "refunded"]
Campos adicionales: Sí
PickupPointAddressData
PickupPointAddressData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
address_line_1Cadena de textoObligatorioPrimera línea de dirección.
minLength:1maxLength:240cityCadena de textoObligatorioCiudad o localidad.
minLength:1maxLength:160postal_codeCadena de textoObligatorioCódigo postal.
minLength:1maxLength:32
Campos adicionales: No
PickupPointCoordinatesData
PickupPointCoordinatesData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
latitudeNúmeroObligatorioWGS84 φ (°)
minimum:-90.0maximum:90.0longitudeNúmeroObligatorioWGS84 λ (°)
minimum:-180.0maximum:180.0
Campos adicionales: No
PickupPointData
PickupPointData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
address_line1Cadena de textoObligatorioPrimera línea de dirección.
cityCadena de textoObligatorioCiudad o localidad.
codeCadena de textoObligatorioCódigo estable legible por programas.
country_codeCadena de textoObligatorioCódigo del país.
kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["locker", "pickup_point"]
latitudeNúmero nullObligatorioWGS84 φ (°)
location_descriptionCadena de texto nullObligatorioDescripción en el idioma seleccionado.
longitudeNúmero nullObligatorioWGS84 λ (°)
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
opening_hoursCadena de texto nullObligatorioOpening hours
operatorCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
postal_codeCadena de textoObligatorioCódigo postal.
Campos adicionales: No
PickupPointSummaryData
PickupPointSummaryData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
codeCadena de textoObligatorioCódigo estable legible por programas.
Restricciones
pattern"^[A-Za-z0-9_-]{1,63}$"
country_codeCadena de textoObligatorioCódigo del país.
Restricciones
pattern"^[A-Z]{2}$"
environmentCadena de textoObligatorioInformación del entorno asociada al registro.
Restricciones
enum["live", "sandbox"]
kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["locker", "pickup_point"]
operatorCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
minLength:1maxLength:63
Campos adicionales: No
Información del cliente registrada para este recurso
RequestCustomerData · Esquema · Esquemas de datos: Pedidos
emailCadena de textoObligatorioDirección de correo electrónico.
nameCadena de textoObligatorioNombre del recurso en el contexto correspondiente.
Campos adicionales: No
Método de entrega e información asociada
ShippingData · Esquema · Esquemas de datos: Pedidos
amountMoneyDataObligatorioImporte de envío con impuestos registrado en el pedido como MoneyData. Los cambios fiscales posteriores no modifican este importe histórico.
datesDeliveryDatesDataObligatorioFechas de envío y entrega. La lista y el detalle de pedidos incluyen delivery.dates. Las fechas YYYY-MM-DD son previstas y no confirman el envío. Las fechas actuales tienen prioridad; los pedidos antiguos usan la estimación guardada. Los valores borrados o desconocidos son null. El detalle también incluye todas las líneas e imágenes de productos.
method_codeCadena de texto nullObligatorioCódigo del método de entrega o pago.
method_nameCadena de texto nullObligatorioNombre del método de entrega o pago.
pickup_pointPickupPointSummaryDatanullObligatorioPunto de recogida
recipient_modeCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
Campos adicionales: No
ShippingDetailData
ShippingDetailData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
amountMoneyDataObligatorioImporte de envío con impuestos registrado en el pedido como MoneyData. Los cambios fiscales posteriores no modifican este importe histórico.
datesDeliveryDatesDataObligatorioFechas de envío y entrega. La lista y el detalle de pedidos incluyen delivery.dates. Las fechas YYYY-MM-DD son previstas y no confirman el envío. Las fechas actuales tienen prioridad; los pedidos antiguos usan la estimación guardada. Los valores borrados o desconocidos son null. El detalle también incluye todas las líneas e imágenes de productos.
discount_grossMoneyDataObligatorioImporte bruto · Descuentos; Desconocido: null; cero conocido: 0.
discount_netMoneyDatanullObligatorioImporte neto · Descuentos; Desconocido: null; cero conocido: 0.
discount_taxMoneyDatanullObligatorioImporte del impuesto · Descuentos; Desconocido: null; cero conocido: 0.
discountsLista <OrderDeliveryDiscountData> nullObligatorioEnvío · Descuentos; []: 0; null: Desconocido: null; cero conocido: 0.
grossMoneyDataObligatorioImporte bruto · Después de descuentos; Desconocido: null; cero conocido: 0.
method_codeCadena de texto nullObligatorioCódigo del método de entrega o pago.
method_nameCadena de texto nullObligatorioNombre del método de entrega o pago.
netMoneyDatanullObligatorioImporte neto · Después de descuentos; Desconocido: null; cero conocido: 0.
original_grossMoneyDataObligatorioImporte bruto · Envío · Antes de descuentos; Desconocido: null; cero conocido: 0.
original_netMoneyDatanullObligatorioImporte neto · Envío · Antes de descuentos; Desconocido: null; cero conocido: 0.
original_taxMoneyDatanullObligatorioImporte del impuesto · Envío · Antes de descuentos; Desconocido: null; cero conocido: 0.
pickup_pointDeliveryPickupPointDatanullObligatorioPunto de recogida
recipient_modeCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
taxMoneyDatanullObligatorioImporte del impuesto · Después de descuentos; Desconocido: null; cero conocido: 0.
tax_category_idCadena de texto nullObligatorioIdentificador de categoría fiscal · Datos guardados del pedido; null.
tax_category_nameCadena de texto nullObligatorioNombre guardado de la categoría fiscal; null.
tax_rateCadena de texto nullObligatoriotax_rate · Datos guardados del pedido: "0.23" = 23%; "0" ≠ null.
Campos adicionales: No