curl --request POST \
--url https://sandbox.external.cashea.app/v2/inventory/products/bulk/async \
--header 'Authorization: ApiKey TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"products": [
{
"sku": "TEST-SMARTPHONE-001",
"title": "Sumsung Galaxo Z54",
"description": "Smartphone de prueba",
"categoryUuid": "5f0ba846-e37f-4a67-8f03-95e998996c95",
"brand": "Sumsung",
"model": "Galaxo Z54",
"price": 299.99,
"images": ["https://cdn.photo/800"],
"condition": "NEW",
"digital": false,
"shippable": true,
"weight": 0.5,
"warranty": 12,
"bestInstallmentPlan": 6,
"stock": 25,
"status": true,
"commercialBrands": ["20353c61-45bd-4493-85a6-a264b35429d2"],
"attributes": [ { "attributeId": 1, "valueId": 5 } ]
}
]
}'
{
"data": {
"jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
"status": "PENDING"
}
}
API Inventario
Crear productos (masivo)
Crea uno o varios productos de forma asíncrona
POST
https://sandbox.external.cashea.app
/
v2
/
inventory
/
products
/
bulk
/
async
curl --request POST \
--url https://sandbox.external.cashea.app/v2/inventory/products/bulk/async \
--header 'Authorization: ApiKey TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"products": [
{
"sku": "TEST-SMARTPHONE-001",
"title": "Sumsung Galaxo Z54",
"description": "Smartphone de prueba",
"categoryUuid": "5f0ba846-e37f-4a67-8f03-95e998996c95",
"brand": "Sumsung",
"model": "Galaxo Z54",
"price": 299.99,
"images": ["https://cdn.photo/800"],
"condition": "NEW",
"digital": false,
"shippable": true,
"weight": 0.5,
"warranty": 12,
"bestInstallmentPlan": 6,
"stock": 25,
"status": true,
"commercialBrands": ["20353c61-45bd-4493-85a6-a264b35429d2"],
"attributes": [ { "attributeId": 1, "valueId": 5 } ]
}
]
}'
{
"data": {
"jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
"status": "PENDING"
}
}
Crea uno o varios productos de forma asíncrona. Encola un job y responde
202 con un jobId; el resultado se consulta con GET /v2/inventory/jobs/{jobId}.
Límites: entre 1 y 1.000 productos por request.
Authorization
string
requerido
Formato:
ApiKey TU_API_KEYBody Parameters
object[]
requerido
Lista de productos a crear.
Ocultar producto
Ocultar producto
string
requerido
SKU único (1–64 caracteres).
string
requerido
Título (máx. 256 caracteres).
string
requerido
Descripción (máx. 5000 caracteres).
string
requerido
uuid de la categoría del producto. Tiene que ser una categoría hoja (
hasChildren: false en Listar categorías).string
requerido
Marca del fabricante.
string
requerido
Modelo del producto, sirve para agruparlos.
number
requerido
Precio.
string[]
requerido
1 a 5 URLs válidas, únicas.
string
requerido
Condición del producto. Valores permitidos:
NEW (nuevo), USED (usado), REFURBISHED (reacondicionado).boolean
requerido
Si es digital,
shippable debe ser false.boolean
requerido
Si es enviable.
number
requerido
Peso en kilogramos (kg).
number
Altura en metros.
number
Ancho en metros.
number
Largo en metros.
integer
requerido
Garantía en días.
integer
requerido
Máximo de cuotas:
3, 6, 9 o 12. Se otorgan todos los planes elegibles hasta ese valor (12 otorga 3, 6, 9 y 12); nunca por encima del máximo.integer
requerido
Unidades disponibles.
boolean
requerido
true: el producto aparece en el buscador del marketplace. false: queda cargado, pero no aparece en el buscador.number
Precio con descuento (menor a
price). Requerido si se envía alguna fecha de descuento.string
Formato ISO 8601. Vigencia del descuento.
string
Formato ISO 8601. Debe ser posterior a
discountStartDate.string[]
uuids de marcas comerciales (máx. 2).
object[]
Pares
attributeId / valueId de la categoría.Response
object
Ocultar job
Ocultar job
string
ID del job. Se usa para consultar el resultado con
GET /v2/inventory/jobs/{jobId}.string
Estado inicial del job:
PENDING.Errors
La respuesta202 solo confirma que el job se encoló. Los fallos por producto no llegan como error HTTP: se consultan con GET /v2/inventory/jobs/{jobId}.
| Código | Descripción |
|---|---|
400 | Body inválido. El campo message indica la validación que falló. |
curl --request POST \
--url https://sandbox.external.cashea.app/v2/inventory/products/bulk/async \
--header 'Authorization: ApiKey TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"products": [
{
"sku": "TEST-SMARTPHONE-001",
"title": "Sumsung Galaxo Z54",
"description": "Smartphone de prueba",
"categoryUuid": "5f0ba846-e37f-4a67-8f03-95e998996c95",
"brand": "Sumsung",
"model": "Galaxo Z54",
"price": 299.99,
"images": ["https://cdn.photo/800"],
"condition": "NEW",
"digital": false,
"shippable": true,
"weight": 0.5,
"warranty": 12,
"bestInstallmentPlan": 6,
"stock": 25,
"status": true,
"commercialBrands": ["20353c61-45bd-4493-85a6-a264b35429d2"],
"attributes": [ { "attributeId": 1, "valueId": 5 } ]
}
]
}'
{
"data": {
"jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
"status": "PENDING"
}
}
¿Esta página le ayudó?