{
"code": "ERROR_CODE_ACCESS_DENIED",
"message": "Invalid API key.",
"payload": ""
}
API Reference
Empujar productos
Alta, modificación o baja de productos, en lote. Idempotente por event_id;
los eventos más viejos que lo ya aplicado se descartan (skipped_stale);
un ítem inválido no rechaza el lote (rejected por ítem).
action: "delete" desactiva los productos listados (no se borran: los
pedidos históricos siguen siendo legibles).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Xenda Partner API","description":"API para integraciones externas con la plataforma Xenda: envío de templates de WhatsApp vía campañas y webhook de respuestas.","colors":{"primary":"#6D28D9","light":"#8B5CF6","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_light.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=e0fc539a255c677092c01ceedeb704cb","dark":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_dark.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=be28a74bd4bee9a2dfb34f44a8353321","href":"https://xenda.ai"},"favicon":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/favicon.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=27cb4692e2a28b4bf23205536dae9a4c","footer":{"links":[{"header":"Xenda","items":[{"label":"Sitio web","href":"https://xenda.ai"},{"label":"Contacto","href":"mailto:contacto@xenda.ai"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xenda","hasAudioNarration":false,"actualSubdomain":"xenda","customDomains":["partner-api.xenda.ai"],"gitSource":{"type":"github","owner":"gonzarodriguez89","repo":"xenda-partner-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"06f03602-dccf-4ea1-9e3e-3bf8399cdf17","liveDeploymentHistoryId":"6acd202305a84ceec519dbc3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acd202305a84ceec519dbc3"},"entitlements":{},"buildId":"6acd202305a84ceec519dbc3","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"POS Bridge","count":9},{"language":"default","tag":"Campañas de WhatsApp","count":6},{"language":"default","tag":"Empezar","count":5},{"language":"default","tag":"Novedades","count":2},{"language":"default","tag":"Webhooks","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/empujar-productos","slug":"/api-reference/empujar-productos","pageMetadata":{"title":"Empujar productos","description":"Alta, modificación o baja de productos, en lote. Idempotente por `event_id`;\nlos eventos más viejos que lo ya aplicado se descartan (`skipped_stale`);\nun ítem inválido no rechaza el lote (`rejected` por ítem).\n\n`action: \"delete\"` desactiva los productos listados (no se borran: los\npedidos históricos siguen siendo legibles).\n","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/catalog/items","href":"/api-reference/empujar-productos","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Alta, modificación o baja de productos, en lote. Idempotente por \", _jsx(_components.code, {\n children: \"event_id\"\n }), \";\\nlos eventos más viejos que lo ya aplicado se descartan (\", _jsx(_components.code, {\n children: \"skipped_stale\"\n }), \");\\nun ítem inválido no rechaza el lote (\", _jsx(_components.code, {\n children: \"rejected\"\n }), \" por ítem).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"action: \\\"delete\\\"\"\n }), \" desactiva los productos listados (no se borran: los\\npedidos históricos siguen siendo legibles).\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Empujar productos","description":"Alta, modificación o baja de productos, en lote. Idempotente por `event_id`;\nlos eventos más viejos que lo ya aplicado se descartan (`skipped_stale`);\nun ítem inválido no rechaza el lote (`rejected` por ítem).\n\n`action: \"delete\"` desactiva los productos listados (no se borran: los\npedidos históricos siguen siendo legibles).\n","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/catalog/items","href":"/api-reference/empujar-productos","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"pushCatalogItems","summary":"Empujar productos","description":"Alta, modificación o baja de productos, en lote. Idempotente por `event_id`;\nlos eventos más viejos que lo ya aplicado se descartan (`skipped_stale`);\nun ítem inválido no rechaza el lote (`rejected` por ítem).\n\n`action: \"delete\"` desactiva los productos listados (no se borran: los\npedidos históricos siguen siendo legibles).\n","requestBody":"8327b44e-4a9a-48f1-8855-9872df2944a5","responses":{"200":"e59f3536-2c1f-45d1-ab76-afe60b9f7b81","403":"8d92c8d0-d225-43e3-92d9-8e3b2ddb815d"},"method":"post","type":"path","servers":["cc95c7b7-0837-42ae-8ad2-de587f162e4a"],"security":["fb8078b5-cff4-4b14-a704-a49b922d921a"],"path":"/v1/catalog/items","baseUrlOptions":["https://api.automationhub.one/api:07fkGLk_"],"title":"Empujar productos","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["event_id","occurred_at","items"],"properties":{"event_id":{"type":"string","description":"ID único del evento en tu sistema. Reintentar con el mismo `event_id` es seguro.","isRequired":true,"uniqueKey":"event_id","typeLabel":"string"},"occurred_at":{"type":"string","format":"date-time","description":"Cuándo ocurrió el cambio en tu sistema. Define el orden entre eventos.","isRequired":true,"uniqueKey":"occurred_at","typeLabel":"string\u003cdate-time>"},"items":{"type":"array","items":{"type":"object","required":["codigo"],"properties":{"codigo":{"type":"string","description":"Tu ID estable del producto. `nombre` es obligatorio en `upsert`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].codigo","typeLabel":"string"},"nombre":{"type":"string","uniqueKey":"\\items.items.[INDEX].nombre","typeLabel":"string"},"categoria":{"type":"string","uniqueKey":"\\items.items.[INDEX].categoria","typeLabel":"string"},"precio":{"type":"number","uniqueKey":"\\items.items.[INDEX].precio","typeLabel":"number"},"deshabilitado":{"type":"boolean","default":false,"uniqueKey":"\\items.items.[INDEX].deshabilitado","typeLabel":"boolean"},"max_opciones":{"type":"integer","description":"Opcional — cuántas opciones admite el producto (ej. 4 sabores en un kilo).\nSi tu sistema no maneja este dato, se configura desde la plataforma Xenda.\n","uniqueKey":"\\items.items.[INDEX].max_opciones","typeLabel":"integer"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"store_id":{"type":"integer","description":"Opcional. Verificación cruzada contra la sucursal de la key (403 si no coincide).","uniqueKey":"store_id","typeLabel":"integer"},"action":{"type":"string","enum":["upsert","delete"],"default":"upsert","uniqueKey":"action","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"event_id":"pos-evt-20260730-001","occurred_at":"2026-07-30T13:00:00-03:00","action":"upsert","items":[{"codigo":"1001","nombre":"Kilo de helado","categoria":"Helados","precio":16000,"deshabilitado":false}]},"examples":{"Example":{"title":"Example","value":{"event_id":"pos-evt-20260730-001","occurred_at":"2026-07-30T13:00:00-03:00","action":"upsert","items":[{"codigo":"1001","nombre":"Kilo de helado","categoria":"Helados","precio":16000,"deshabilitado":false}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e59f3536-2c1f-45d1-ab76-afe60b9f7b81":{"description":"Resultado del lote (o replay idempotente si el `event_id` ya se procesó).","content":{"application/json":{"schema":{"type":"object","properties":{"duplicate":{"type":"boolean","description":"`true` si el `event_id` ya se había procesado (no se reprocesó nada).","uniqueKey":"duplicate","typeLabel":"boolean"},"accepted":{"type":"integer","uniqueKey":"accepted","typeLabel":"integer"},"skipped_stale":{"type":"integer","description":"Ítems descartados por ser más viejos que lo ya aplicado.","uniqueKey":"skipped_stale","typeLabel":"integer"},"rejected":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","uniqueKey":"rejected.items.[INDEX].codigo","typeLabel":"string"},"error":{"type":"string","uniqueKey":"rejected.items.[INDEX].error","typeLabel":"string"}},"uniqueKey":"rejected.items.[INDEX]","typeLabel":"object"},"uniqueKey":"rejected","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"duplicate":true,"accepted":123,"skipped_stale":123,"rejected":[{"codigo":"\u003cstring>","error":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"8d92c8d0-d225-43e3-92d9-8e3b2ddb815d":{"description":"Key inválida, inactiva o `store_id` que no corresponde a la key.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"payload":{"oneOf":[{}],"uniqueKey":"payload","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"ERROR_CODE_ACCESS_DENIED","message":"Invalid API key.","payload":""},"examples":{"Example":{"title":"Example","value":{"code":"ERROR_CODE_ACCESS_DENIED","message":"Invalid API key.","payload":""}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"fb8078b5-cff4-4b14-a704-a49b922d921a":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Key por sucursal provista por Xenda (formato `xnd_...`).","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"cc95c7b7-0837-42ae-8ad2-de587f162e4a":{"url":"https://api.automationhub.one/api:07fkGLk_","description":"Producción (sandbox = misma URL con key de la sucursal demo)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Key por sucursal provista por Xenda (formato `xnd_...`).","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Key por sucursal provista por Xenda (formato `xnd_...`).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi-pos.yaml"},"subdomain":"xenda","siteName":"Xenda Partner API","title":"Empujar productos - Xenda Partner API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T18:00:09.007Z","originalFileLocation":"api-reference/empujar-productos.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Alta, modificación o baja de productos, en lote. Idempotente por event_id; los eventos más viejos que lo ya aplicado se descartan (skipped_stale); un ítem inválido no rechaza el lote (rejected por ítem). action: \u0026quot;delete\u0026quot; desactiva los productos listados (no se borran: los pedidos históricos siguen siendo legibles).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Xenda Partner API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Empujar productos - Xenda Partner API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Alta, modificación o baja de productos, en lote. Idempotente por event_id; los eventos más viejos que lo ya aplicado se descartan (skipped_stale); un ítem inválido no rechaza el lote (rejected por ítem). action: \u0026quot;delete\u0026quot; desactiva los productos listados (no se borran: los pedidos históricos siguen siendo legibles).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xenda Partner API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://partner-api.xenda.ai/api-reference/empujar-productos\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xenda.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Empujar+productos\u0026amp;description=Alta%2C+modificaci%C3%B3n+o+baja+de+productos%2C+en+lote.+Idempotente+por+%60event_id%60%3B%0Alos+eventos+m%C3%A1s+viejos+que+lo+ya+aplicado+se+descartan+%28%60skipped_stale%60%29%3B%0Aun+%C3%ADtem+i\u0026amp;theme=396d13e6644a1062fc958a72\u0026amp;signature=480f99418386f341cf9e87dc5ac0513f2b0b4e5affc17e63cbd6aac95e9b688b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Empujar productos - Xenda Partner API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Alta, modificación o baja de productos, en lote. Idempotente por event_id; los eventos más viejos que lo ya aplicado se descartan (skipped_stale); un ítem inválido no rechaza el lote (rejected por ítem). action: \u0026quot;delete\u0026quot; desactiva los productos listados (no se borran: los pedidos históricos siguen siendo legibles).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xenda.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Empujar+productos\u0026amp;description=Alta%2C+modificaci%C3%B3n+o+baja+de+productos%2C+en+lote.+Idempotente+por+%60event_id%60%3B%0Alos+eventos+m%C3%A1s+viejos+que+lo+ya+aplicado+se+descartan+%28%60skipped_stale%60%29%3B%0Aun+%C3%ADtem+i\u0026amp;theme=396d13e6644a1062fc958a72\u0026amp;signature=480f99418386f341cf9e87dc5ac0513f2b0b4e5affc17e63cbd6aac95e9b688b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xenda Partner API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D28D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://partner-api.xenda.ai/api-reference/empujar-productos\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/empujar-productos.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://partner-api.xenda.ai/#organization\",\"name\":\"Xenda Partner API\",\"url\":\"https://partner-api.xenda.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_light.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=e0fc539a255c677092c01ceedeb704cb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://partner-api.xenda.ai#website\",\"name\":\"Xenda Partner API\",\"url\":\"https://partner-api.xenda.ai\",\"publisher\":{\"@id\":\"https://partner-api.xenda.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://partner-api.xenda.ai/api-reference/empujar-productos#webpage\",\"url\":\"https://partner-api.xenda.ai/api-reference/empujar-productos\",\"name\":\"Empujar productos\",\"description\":\"Alta, modificación o baja de productos, en lote. Idempotente por event_id; los eventos más viejos que lo ya aplicado se descartan (skipped_stale); un ítem inválido no rechaza el lote (rejected por ítem). action: \\\"delete\\\" desactiva los productos listados (no se borran: los pedidos históricos siguen siendo legibles).\",\"dateModified\":\"2026-10-12T18:00:09.007Z\",\"isPartOf\":{\"@id\":\"https://partner-api.xenda.ai#website\"},\"breadcrumb\":{\"@id\":\"https://partner-api.xenda.ai/api-reference/empujar-productos#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://partner-api.xenda.ai/api-reference/empujar-productos#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Xenda Partner API\",\"item\":\"https://partner-api.xenda.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Empujar productos\",\"item\":\"https://partner-api.xenda.ai/api-reference/empujar-productos\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://partner-api.xenda.ai/api-reference/empujar-productos#apireference\",\"headline\":\"Empujar productos\",\"name\":\"Empujar productos\",\"description\":\"Alta, modificación o baja de productos, en lote. Idempotente por event_id; los eventos más viejos que lo ya aplicado se descartan (skipped_stale); un ítem inválido no rechaza el lote (rejected por ítem). action: \\\"delete\\\" desactiva los productos listados (no se borran: los pedidos históricos siguen siendo legibles).\",\"url\":\"https://partner-api.xenda.ai/api-reference/empujar-productos\",\"mainEntityOfPage\":{\"@id\":\"https://partner-api.xenda.ai/api-reference/empujar-productos#webpage\"},\"dateModified\":\"2026-10-12T18:00:09.007Z\",\"publisher\":{\"@id\":\"https://partner-api.xenda.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://partner-api.xenda.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xenda Partner API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Xenda Partner API","nav":{"global":null,"tabs":[{"tab":"Campañas de WhatsApp","pages":[{"title":"Campañas de WhatsApp","href":"/introduccion"}]},{"tab":"POS Bridge","groups":[{"group":"Empezar","pages":[{"title":"POS Bridge — Introducción","href":"/pos-introduccion"},{"title":"Quickstart (10 minutos)","href":"/pos-quickstart"},{"title":"Estados del pedido","description":"Ciclo de vida del pedido, qué informa tu POS y qué maneja Xenda.","href":"/pos-estados"}]},{"group":"API Reference","pages":[{"group":"API Reference","pages":[{"title":"Empujar productos","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/catalog/items","href":"/api-reference/empujar-productos"},{"title":"Empujar opciones (sabores)","description":"Alta, modificación o baja de opciones, en lote. El `grupo` (ej. \"Sabores\")\nse crea automáticamente la primera vez que aparece. Mismas reglas de\nidempotencia, orden de eventos y errores por ítem que los productos.\n\nCargar opciones no las asocia a ningún producto: qué productos llevan\nopciones y de qué grupo se configura del lado Xenda, como parte de la\npuesta en marcha de la sucursal.\n","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/catalog/options","href":"/api-reference/empujar-opciones-sabores"},{"title":"Consultar pedidos (polling)","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml get /v1/orders","href":"/api-reference/consultar-pedidos-polling"},{"title":"Crear un pedido de prueba","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/test/orders","href":"/api-reference/crear-un-pedido-de-prueba"},{"title":"Informar cambio de estado","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml post /v1/orders/{order_id}/status","href":"/api-reference/informar-cambio-de-estado"},{"title":"Historial de sincronizaciones","deprecated":null,"version":null,"openapi":"/openapi-pos.yaml get /v1/sync-log","href":"/api-reference/historial-de-sincronizaciones"}]}]}]},{"tab":"Novedades","pages":[{"title":"Novedades","href":"/changelog"}]}]},"basePath":"","title":"Empujar productos - Xenda Partner API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}