Esquemas de datos
Cantidades asignadas a ubicaciones del almacén
AllocationData · Esquema · Esquemas de datos: Inventario
location_codeCadena de textoObligatorioCódigo de la ubicación del almacén.
location_idCadena de textoObligatorioIdentificador de la ubicación del almacén.
location_nameCadena de textoObligatorioNombre de la ubicación del almacén.
on_handNúmero enteroObligatorioCantidad física en existencias.
Campos adicionales: No
ApiResponse[CodeContentData]
ApiResponse_CodeContentData_ · Los códigos se devuelven en JSON y los archivos en binario. Cada petición exige Bearer y el permiso reveal.
dataCodeContentDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
ApiResponse[DigitalUploadData]
ApiResponse_DigitalUploadData_ · Comprueba tamaño, suma de verificación y formato. Una subida lista todavía no confirma la recepción de existencias.
dataDigitalUploadDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
ApiResponse[ImportData]
ApiResponse_ImportData_ · Comprueba su estado, versión y validación. El borrador pertenece a la clave API que lo creó.
dataImportDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
Listar · Existencias — Inventario — Respuesta
ApiResponse_list_StockData__ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
dataLista <StockData> ObligatorioEjemplo de respuesta · ApiResponse_list_StockData__.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
ApiResponse[PoolData]
ApiResponse_PoolData_ · Lee la configuración y las cantidades antes de cambiarlas. La respuesta no incluye códigos ni archivos.
dataPoolDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
Obtener · Existencias — Inventario — Respuesta
ApiResponse_StockDetailData_ · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
dataStockDetailDataObligatorioEjemplo de respuesta · StockDetailData.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
ApiResponse[UnitsData]
ApiResponse_UnitsData_ · Consulta hasta 100 unidades por página. La lista muestra metadatos sin revelar los códigos.
dataUnitsDataObligatorioContenido de una respuesta correcta.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatorioMetadatos de la respuesta.
Campos adicionales: No
CodeContentData
CodeContentData · Los códigos se devuelven en JSON y los archivos en binario. Cada petición exige Bearer y el permiso reveal.
codeCadena de textoObligatorioEl código digital exacto. Conserva las mayúsculas y los espacios internos.
minLength:1maxLength:512delivery_idCadena de texto nullOpcionalID de la entrega o asignación del pedido.
Cadena de texto:format:"uuid"kindCadena de textoOpcionalVariante de la estructura de datos definida por los valores admitidos.
const:"code"payload_idCadena de textoObligatorioID del contenido; no es una URL pública de descarga.
format:"uuid"unit_idCadena de textoObligatorioID de un código o archivo individual.
format:"uuid"
Campos adicionales: No
DigitalUploadCreate
DigitalUploadCreate · Reserva espacio para un archivo y vincúlalo a una importación o a la unidad que sustituirá.
consumer_idCadena de textoObligatorioID de la importación o unidad vinculada.
format:"uuid"consumer_kindCadena de textoObligatorioDestino de la subida: digital_import / digital_unit.
Restricciones
enum["digital_import", "digital_unit"]
filenameCadena de textoObligatorioArchivo
minLength:1maxLength:255purposeCadena de textoObligatoriodigital_import: TXT/CSV; digital_unit: archivo vendido individualmente.
Restricciones
enum["digital_unit", "digital_import"]
sha256Cadena de textoObligatorioSHA-256 (hex, 64)
Restricciones
pattern"^[0-9a-f]{64}$"
size_bytesNúmero enteroObligatorioTamaño en bytes
minimum:1maximum:262144000
Campos adicionales: No
DigitalUploadData
DigitalUploadData · Comprueba tamaño, suma de verificación y formato. Una subida lista todavía no confirma la recepción de existencias.
consumer_idCadena de textoObligatorioID de la importación o unidad vinculada.
format:"uuid"consumer_kindCadena de textoObligatorioDestino de la subida: digital_import / digital_unit.
Restricciones
enum["digital_import", "digital_unit"]
expires_atCadena de textoObligatorioFecha de caducidad de esta carga o importación.
format:"date-time"filenameCadena de textoObligatorioArchivo
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
format:"uuid"product_idCadena de textoObligatorioIdentificador del producto.
purposeCadena de textoObligatoriodigital_import: TXT/CSV; digital_unit: archivo vendido individualmente.
Restricciones
enum["digital_unit", "digital_import"]
received_bytesNúmero enteroObligatorioSubiendo… · Tamaño en bytes
sha256Cadena de textoObligatorioSHA-256 (hex, 64)
size_bytesNúmero enteroObligatorioTamaño en bytes
statusCadena de textoObligatorioEstado admitido por esta operación concreta.
Campos adicionales: No
ImportCommit
ImportCommit · Crea una entrega prevista o recibida con el lote validado. Una entrega prevista aún no se puede vender.
delivered_atCadena de textoObligatorioFecha y hora de entrega.
format:"date-time"expected_delivery_versionNúmero enteroObligatorioVersión de la entrega; 0 para una entrega nueva.
minimum:0maximum:0expected_sales_limit_versionNúmero entero nullOpcionalVersión del límite de venta; obligatoria con publish_for_sale=true.
Número entero:minimum:0maximum:9223372036854775807expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1maximum:9223372036854775807location_idCadena de textoObligatorioIdentificador de la ubicación del almacén.
Restricciones
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
publish_for_saleBooleanoOpcionaltrue aumenta también el límite finito de venta; false lo deja igual.
statusCadena de textoObligatorioEstado admitido por esta operación concreta.
Restricciones
enum["planned", "received"]
validation_digestCadena de textoObligatorioSuma de verificación de validación; envíala sin cambios al confirmar.
Restricciones
pattern"^[0-9a-f]{64}$"
warehouse_idCadena de textoObligatorioIdentificador del almacén.
Restricciones
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
Campos adicionales: No
ImportCreate
ImportCreate · Prepara un borrador con hasta 1000 códigos o 100 archivos. Todavía no aumenta las existencias a la venta.
countNúmero enteroObligatorioNúmero exacto de unidades del lote.
minimum:1maximum:1000kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["code", "file"]
Campos adicionales: No
ImportData
ImportData · Comprueba su estado, versión y validación. El borrador pertenece a la clave API que lo creó.
delivery_idCadena de texto nullObligatorioID de la entrega o asignación del pedido.
delivery_statusCadena de texto nullObligatorioEstado de entrega: planned / received; null antes de confirmar.
delivery_versionNúmero entero nullObligatorioVersión actual de la entrega de almacén.
expected_countNúmero enteroObligatorioCantidad esperada; se acepta solo el lote completo.
expires_atCadena de textoObligatorioFecha de caducidad de esta carga o importación.
format:"date-time"idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
format:"uuid"kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["code", "file"]
product_idCadena de textoObligatorioIdentificador del producto.
statusCadena de textoObligatorioEstado admitido por esta operación concreta.
validated_countNúmero enteroObligatorioUnidades aceptadas en la última validación correcta.
validation_digestCadena de texto nullObligatorioSuma de verificación de validación; envíala sin cambios al confirmar.
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
ImportReceive
ImportReceive · Recibe las unidades existentes sin volver a importar sus códigos o archivos.
expected_delivery_versionNúmero enteroObligatorioVersión de la entrega; 0 para una entrega nueva.
minimum:1maximum:9223372036854775807expected_sales_limit_versionNúmero entero nullOpcionalVersión del límite de venta; obligatoria con publish_for_sale=true.
Número entero:minimum:0maximum:9223372036854775807expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1maximum:9223372036854775807publish_for_saleBooleanoOpcionaltrue aumenta también el límite finito de venta; false lo deja igual.
Campos adicionales: No
ImportValidate
ImportValidate · Comprueba el lote completo. Los duplicados o entradas incorrectas rechazan el lote; los códigos nunca se recortan.
code_columnCadena de texto nullOpcionalColumna CSV de los códigos; utiliza code.
Cadena de texto:const:"code"expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1maximum:9223372036854775807formatCadena de texto nullOpcionalLista de códigos: txt / csv; usa upload_ids para archivos.
Restricciones · Cadena de texto 1
enum["txt", "csv"]
source_upload_idCadena de texto nullOpcionalSubida privada TXT/CSV lista, perteneciente a esta importación.
Cadena de texto:format:"uuid"upload_idsLista <Cadena de texto> nullOpcional1–100 subidas privadas de archivos listas de esta importación.
Lista:minItems:1maxItems:100Lista / Lista:format:"uuid"
Campos adicionales: No
ImportWithdrawal
ImportWithdrawal · Retira solo las unidades libres. Las reservadas y asignadas siguen vinculadas a sus pedidos.
expected_delivery_versionNúmero enteroObligatorioVersión de la entrega; 0 para una entrega nueva.
minimum:1maximum:9223372036854775807expected_order_versionNúmero enteroObligatorioVersión del orden de asignación, no del pedido del cliente.
minimum:0maximum:9223372036854775807expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:1maximum:9223372036854775807reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500
Campos adicionales: No
Actualizar · Reserva manual — Inventario — Cuerpo de la solicitud
ManualReservationUpdate · 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:9223372036854775807manual_reservedNúmero enteroObligatorioCantidad reservada manualmente.
minimum:0maximum:2147483647reasonCadena de textoOpcionalMotivo registrado para el cambio.
maxLength:500
Campos adicionales: No
PoolChange
PoolChange · Activa códigos o archivos individuales desde Professional. Al desactivarlos se conserva el acceso a compras anteriores.
email_modeCadena de textoOpcionaldisabled: sin correo; order_link: enlace al pedido; code_text: puede incluir códigos.
Restricciones
enum["disabled", "order_link", "code_text"]
enabledBooleanoObligatorioIndica si esta opción está habilitada.
expected_versionNúmero enteroObligatorioVersión leída antes de escribir; si no coincide, se rechaza la actualización.
minimum:0maximum:9223372036854775807retention_daysNúmero entero nullOpcionalnull: sin caducidad; 1–3650 días desde el primer acceso. Los códigos no se borran automáticamente.
Número entero:minimum:1maximum:3650
Campos adicionales: No
PoolCounts
PoolCounts · Lee la configuración y las cantidades antes de cambiarlas. La respuesta no incluye códigos ni archivos.
availableNúmero enteroObligatorioNúmero de unidades libres, no reservadas ni entregadas.
heldNúmero enteroObligatorioUnidades reservadas para pedidos, aún no entregadas.
issuedNúmero enteroObligatorioUnidades ya entregadas a compras pagadas.
plannedNúmero enteroObligatorioUnidades de entregas confirmadas todavía no recibidas.
retiredNúmero enteroObligatorioUnidades retiradas conservadas en el historial.
stagedNúmero enteroObligatorioUnidades de importaciones incompletas, aún fuera del inventario.
Campos adicionales: No
PoolData
PoolData · Lee la configuración y las cantidades antes de cambiarlas. La respuesta no incluye códigos ni archivos.
configuredBooleanoObligatorioIndica si se guardó la configuración del inventario.
countsPoolCountsObligatorioCantidad de unidades por estado de inventario.
email_modeCadena de textoObligatoriodisabled: sin correo; order_link: enlace al pedido; code_text: puede incluir códigos.
Restricciones
enum["disabled", "order_link", "code_text"]
enabledBooleanoObligatorioIndica si esta opción está habilitada.
order_versionNúmero enteroObligatorioVersión del orden de asignación del inventario.
product_idCadena de textoObligatorioIdentificador del producto.
retention_daysNúmero entero nullObligatorionull: sin caducidad; 1–3650 días desde el primer acceso. Los códigos no se borran automáticamente.
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
Campos adicionales: No
Actualizar · Límite de ventas — Inventario — Cuerpo de la solicitud
SalesLimitUpdate · 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:9223372036854775807reasonCadena de textoOpcionalMotivo registrado para el cambio.
maxLength:500sellable_limitNúmero enteroObligatorioLímite de venta: -1 significa ilimitado y 0 deshabilita la disponibilidad para la venta.
minimum:-1maximum:2147483647
Campos adicionales: No
Crear · Ajuste de existencias — Inventario — Cuerpo de la solicitud
StockAdjustmentCreate · 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:9223372036854775807locationsLista <LocationQuantity> ObligatorioUbicaciones del almacén.
minItems:1maxItems:100reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500target_idCadena de textoObligatorioIdentificador del producto o variante afectado por la operación.
Restricciones
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
target_typeCadena de textoObligatorioIndica si la operación afecta a un producto o a una variante.
Restricciones
enum["product", "variant"]
warehouse_idCadena de textoObligatorioIdentificador del almacén.
Restricciones
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
Campos adicionales: No
Actualizar · Existencias — Inventario — Cuerpo de la solicitud
StockAdjustmentUpdate · 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:9223372036854775807locationsLista <LocationQuantity> ObligatorioUbicaciones del almacén.
minItems:1maxItems:100reasonCadena de textoObligatorioMotivo registrado para el cambio.
minLength:1maxLength:500
Campos adicionales: No
Listar · Existencias — Inventario — Respuesta
StockData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
activeBooleanoObligatorioIndica si el recurso está activo.
availableNúmero entero nullObligatorioCantidad disponible para la venta; null representa una cantidad ilimitada.
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (StockData).
manual_reservedNúmero enteroObligatorioCantidad reservada manualmente.
on_handNúmero enteroObligatorioCantidad física en existencias.
reservedNúmero enteroObligatorioCantidad reservada por pedidos.
sellable_limitNúmero enteroObligatorioLímite de venta: -1 significa ilimitado y 0 deshabilita la disponibilidad para la venta.
target_idCadena de textoObligatorioIdentificador del producto o variante afectado por la operación.
target_typeCadena de textoObligatorioIndica si la operación afecta a un producto o a una variante.
Restricciones
enum["product", "variant"]
total_reservedNúmero enteroObligatorioCantidad total reservada.
updated_atCadena de textoObligatorioMomento de la última actualización.
format:"date-time"versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
warehouse_idCadena de textoObligatorioIdentificador del almacén.
Campos adicionales: No
Obtener · Existencias — Inventario — Respuesta
StockDetailData · Campos, tipos y restricciones de los datos aceptados o devueltos por la API.
activeBooleanoObligatorioIndica si el recurso está activo.
allocationsLista <AllocationData> ObligatorioCantidades asignadas a ubicaciones del almacén.
availableNúmero entero nullObligatorioCantidad disponible para la venta; null representa una cantidad ilimitada.
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve. (StockDetailData).
manual_reservedNúmero enteroObligatorioCantidad reservada manualmente.
on_handNúmero enteroObligatorioCantidad física en existencias.
reservedNúmero enteroObligatorioCantidad reservada por pedidos.
sellable_limitNúmero enteroObligatorioLímite de venta: -1 significa ilimitado y 0 deshabilita la disponibilidad para la venta.
target_idCadena de textoObligatorioIdentificador del producto o variante afectado por la operación.
target_typeCadena de textoObligatorioIndica si la operación afecta a un producto o a una variante.
Restricciones
enum["product", "variant"]
total_reservedNúmero enteroObligatorioCantidad total reservada.
updated_atCadena de textoObligatorioMomento de la última actualización.
format:"date-time"versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
warehouse_idCadena de textoObligatorioIdentificador del almacén.
Campos adicionales: No
UnitData
UnitData · Consulta hasta 100 unidades por página. La lista muestra metadatos sin revelar los códigos.
content_stateCadena de textoObligatorioEstado del contenido: present / deleting / deleted.
delivery_idCadena de texto nullObligatorioID de la entrega o asignación del pedido.
filenameCadena de texto nullObligatorioArchivo
idCadena de textoObligatorioIdentificador del recurso; consérvalo tal como se devuelve.
format:"uuid"issued_atCadena de texto nullObligatorioPrimera entrega; null antes de ella.
Cadena de texto:format:"date-time"kindCadena de textoObligatorioVariante de la estructura de datos definida por los valores admitidos.
Restricciones
enum["file", "code"]
location_idCadena de texto nullObligatorioIdentificador de la ubicación del almacén.
mime_typeCadena de texto nullObligatorioTipo de contenido multimedia.
payload_idCadena de textoObligatorioID del contenido; no es una URL pública de descarga.
format:"uuid"product_idCadena de textoObligatorioIdentificador del producto.
size_bytesNúmero entero nullObligatorioTamaño en bytes
sort_orderNúmero enteroObligatorioPosición en la colección ordenada.
stateCadena de textoObligatorioEstado
versionNúmero enteroObligatorioVersión del recurso utilizada para controlar cambios simultáneos.
warehouse_idCadena de texto nullObligatorioIdentificador del almacén.
Campos adicionales: No
UnitDeletion
UnitDeletion · Retira un código o archivo sin vender e indica el motivo. No admite unidades reservadas ni asignadas.
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
UnitReorder
UnitReorder · Envía la página completa sin filtros en el orden deseado. Una versión desactualizada devuelve 409.
expected_order_versionNúmero enteroObligatorioVersión del orden de asignación, no del pedido del cliente.
minimum:1unit_idsLista <Cadena de texto> ObligatorioTodas las unidades de la página sin filtros en el orden deseado.
minItems:2maxItems:100Lista:format:"uuid"window_cursorCadena de texto nullOpcionalCursor de la página sin filtros; null para la primera.
Cadena de texto:maxLength:1024
Campos adicionales: No
UnitReplacement
UnitReplacement · Cambia el código o archivo sin alterar su posición. El cambio queda en el historial del almacén.
codeCadena de texto nullOpcionalEl código digital exacto. Conserva las mayúsculas y los espacios internos.
Cadena de texto:minLength:1maxLength:512expected_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:500upload_idCadena de texto nullOpcionalIdentificador del recurso; consérvalo tal como se devuelve. · upload_id
Cadena de texto:format:"uuid"
Campos adicionales: No
UnitsData
UnitsData · Consulta hasta 100 unidades por página. La lista muestra metadatos sin revelar los códigos.
order_versionNúmero enteroObligatorioVersión del orden de asignación del inventario.
totalNúmero enteroObligatorioImporte total.
unitsLista <UnitData> ObligatorioMetadatos de unidades; el contenido requiere otra petición autorizada.
Campos adicionales: Sí