{"openapi":"3.0.0","paths":{"/v1/me":{"get":{"description":"Quién sos: la key, su organización, la config efectiva y el tamaño del catálogo que ve. Sirve para probar las credenciales.","operationId":"me","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Datos de la key","tags":["Catálogo","Cuenta"]}},"/v1/products":{"get":{"description":"Un producto por fila, con todas sus ofertas: el mismo producto en varios distribuidores (mismo EAN, o misma marca y part number) se agrupa. `bestOffer` es la de stock y menor precio. Paginado por cursor.","operationId":"products","parameters":[{"name":"q","required":false,"in":"query","description":"Texto a buscar en nombre, marca, SKU, part number o EAN. Todas las palabras tienen que aparecer.","schema":{"example":"rtx 4060","type":"string"}},{"name":"brand","required":false,"in":"query","description":"Marca (nombre o id `brd_…`).","schema":{"example":"ASUS","type":"string"}},{"name":"category","required":false,"in":"query","description":"Categoría (nombre o id `cat_…`).","schema":{"example":"Placas de video","type":"string"}},{"name":"subcategory","required":false,"in":"query","description":"Subcategoría (nombre o id `cat_…`).","schema":{"type":"string"}},{"name":"provider","required":false,"in":"query","description":"Distribuidor (id `prv_…`; con identidad visible, también la clave).","schema":{"example":"prv_3kT9xQ2mWvLp0aZr","type":"string"}},{"name":"inStock","required":false,"in":"query","description":"Solo con stock (`true`) o solo sin stock (`false`). Sin stock solo aparece si la key lo incluye.","schema":{"type":"boolean"}},{"name":"minPrice","required":false,"in":"query","description":"Precio mínimo (precio de venta final en la moneda de la key).","schema":{"example":100,"type":"number"}},{"name":"maxPrice","required":false,"in":"query","description":"Precio máximo (precio de venta final en la moneda de la key).","schema":{"example":2500,"type":"number"}},{"name":"updatedSince","required":false,"in":"query","description":"Solo lo que cambió desde esta fecha (ISO 8601).","schema":{"example":"2026-10-01T00:00:00Z","type":"string"}},{"name":"ean","required":false,"in":"query","description":"EAN / GTIN exacto.","schema":{"example":"4711081976386","type":"string"}},{"name":"partNumber","required":false,"in":"query","description":"Part number exacto (sin distinguir mayúsculas, espacios ni guiones).","schema":{"example":"DUAL-RTX4060-O8G","type":"string"}},{"name":"sort","required":false,"in":"query","description":"Orden. `-` adelante = descendente. `relevance` solo tiene sentido con `q` (default con `q`; sin `q` el default es `name`).","schema":{"enum":["relevance","name","-name","price","-price","updatedAt","-updatedAt"],"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Cantidad por página (1 a 500).","schema":{"minimum":1,"maximum":500,"default":100,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Cursor de `pagination.nextCursor` de la página anterior.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductListSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Listar productos (agrupados)","tags":["Catálogo"]}},"/v1/products/{productId}":{"get":{"description":"El producto con todas sus ofertas.","operationId":"product","parameters":[{"name":"productId","required":true,"in":"path","schema":{"example":"prd_2Lk9QwE5rTyU8iOp3aSd7f","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetailSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"404":{"description":"No existe o no es visible para la key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Ver un producto","tags":["Catálogo"]}},"/v1/offers":{"get":{"description":"Una fila por producto y distribuidor, con los datos básicos del producto. Mismos filtros que /v1/products.","operationId":"offers","parameters":[{"name":"q","required":false,"in":"query","description":"Texto a buscar en nombre, marca, SKU, part number o EAN. Todas las palabras tienen que aparecer.","schema":{"example":"rtx 4060","type":"string"}},{"name":"brand","required":false,"in":"query","description":"Marca (nombre o id `brd_…`).","schema":{"example":"ASUS","type":"string"}},{"name":"category","required":false,"in":"query","description":"Categoría (nombre o id `cat_…`).","schema":{"example":"Placas de video","type":"string"}},{"name":"subcategory","required":false,"in":"query","description":"Subcategoría (nombre o id `cat_…`).","schema":{"type":"string"}},{"name":"provider","required":false,"in":"query","description":"Distribuidor (id `prv_…`; con identidad visible, también la clave).","schema":{"example":"prv_3kT9xQ2mWvLp0aZr","type":"string"}},{"name":"inStock","required":false,"in":"query","description":"Solo con stock (`true`) o solo sin stock (`false`). Sin stock solo aparece si la key lo incluye.","schema":{"type":"boolean"}},{"name":"minPrice","required":false,"in":"query","description":"Precio mínimo (precio de venta final en la moneda de la key).","schema":{"example":100,"type":"number"}},{"name":"maxPrice","required":false,"in":"query","description":"Precio máximo (precio de venta final en la moneda de la key).","schema":{"example":2500,"type":"number"}},{"name":"updatedSince","required":false,"in":"query","description":"Solo lo que cambió desde esta fecha (ISO 8601).","schema":{"example":"2026-10-01T00:00:00Z","type":"string"}},{"name":"ean","required":false,"in":"query","description":"EAN / GTIN exacto.","schema":{"example":"4711081976386","type":"string"}},{"name":"partNumber","required":false,"in":"query","description":"Part number exacto (sin distinguir mayúsculas, espacios ni guiones).","schema":{"example":"DUAL-RTX4060-O8G","type":"string"}},{"name":"sort","required":false,"in":"query","description":"Orden. `-` adelante = descendente. `relevance` solo tiene sentido con `q` (default con `q`; sin `q` el default es `name`).","schema":{"enum":["relevance","name","-name","price","-price","updatedAt","-updatedAt"],"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Cantidad por página (1 a 500).","schema":{"minimum":1,"maximum":500,"default":100,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Cursor de `pagination.nextCursor` de la página anterior.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferListSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Listar ofertas","tags":["Catálogo"]}},"/v1/offers/{offerId}":{"get":{"description":"Con `fields.raw` en la key incluye `raw` (datos crudos del distribuidor); con `fields.priceHistory`, los últimos cambios de precio.","operationId":"offer","parameters":[{"name":"offerId","required":true,"in":"path","schema":{"example":"off_7Hq2Zk9LmXwR4tNc1aBv0e","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferDetailSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"404":{"description":"No existe o no es visible para la key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Ver una oferta","tags":["Catálogo"]}},"/v1/offers/{offerId}/price-history":{"get":{"description":"Cada cambio de precio de la oferta en los últimos 12 meses (se registra solo cuando el precio cambia).","operationId":"priceHistory","parameters":[{"name":"offerId","required":true,"in":"path","schema":{"example":"off_7Hq2Zk9LmXwR4tNc1aBv0e","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceHistorySchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Historial de precio","tags":["Catálogo"]}},"/v1/brands":{"get":{"description":"Marcas del catálogo visible para la key (nombres unificados por NODO), con cantidad de productos.","operationId":"brands","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandsSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Marcas","tags":["Catálogo","Taxonomía"]}},"/v1/categories":{"get":{"description":"Árbol categoría → subcategoría (taxonomía unificada de NODO), con cantidad de productos.","operationId":"categories","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoriesSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Categorías","tags":["Catálogo","Taxonomía"]}},"/v1/providers":{"get":{"description":"Los distribuidores de la key (con alias si la identidad está oculta), cantidad de ofertas y estado de su sincronización.","operationId":"providers","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvidersSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Distribuidores","tags":["Catálogo"]}},"/v1/fx":{"get":{"description":"Las cotizaciones disponibles y la que usa la key para convertir a pesos.","operationId":"fx","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FxListSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Cotizaciones del dólar","tags":["Catálogo","Cuenta"]}},"/v1/changes":{"get":{"description":"Lo que cambió desde tu último cursor, en orden: altas, cambios (precio, stock, ficha) y bajas, más pausas de sincronización de un distribuidor. Guardá `nextCursor` y volvé a consultar. Los cursores valen 30 días.","operationId":"changesFeed","parameters":[{"name":"cursor","required":false,"in":"query","description":"Cursor de la consulta anterior. Sin cursor devuelve el cursor actual (arrancá desde ahí después de un export).","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Cambios por página (1 a 500).","schema":{"minimum":1,"maximum":500,"default":200,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangesSchema"}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"410":{"description":"El cursor venció (más de 30 días): hacé un export y pedí un cursor nuevo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Cambios incrementales","tags":["Sincronización"]}},"/v1/export":{"get":{"description":"Catálogo completo con la config de la key, en CSV (UTF-8 con BOM), XLSX (hasta 100.000 filas) o JSON. Se descarga como archivo.","operationId":"export","parameters":[{"name":"format","required":false,"in":"query","schema":{"default":"csv","enum":["csv","xlsx","json"],"type":"string"}},{"name":"view","required":false,"in":"query","description":"Default: la vista por defecto de la key.","schema":{"enum":["products","offers"],"type":"string"}},{"name":"delimiter","required":false,"in":"query","description":"Separador del CSV (`;` para Excel en español).","schema":{"default":",","enum":[",",";"],"type":"string"}}],"responses":{"200":{"description":"El archivo."},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Exportar el catálogo","tags":["Sincronización"]}},"/v1/feeds/{feedToken}/google.xml":{"get":{"description":"RSS 2.0 con atributos `g:`. Requiere `feed.productUrlTemplate` en la key.","operationId":"google","parameters":[{"name":"feedToken","required":true,"in":"path","schema":{"example":"nodo_ft_…","type":"string"}}],"responses":{"422":{"description":"Falta configurar el link de los productos.","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"summary":"Feed para Google Merchant Center","tags":["Feeds"],"security":[]}},"/v1/feeds/{feedToken}/meta.csv":{"get":{"description":"CSV con las columnas del catálogo de Meta. Requiere `feed.productUrlTemplate` en la key.","operationId":"meta","parameters":[{"name":"feedToken","required":true,"in":"path","schema":{"example":"nodo_ft_…","type":"string"}}],"responses":{"422":{"description":"Falta configurar el link de los productos.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"summary":"Feed para el catálogo de Meta (Facebook e Instagram)","tags":["Feeds"],"security":[]}},"/v1/webhooks":{"get":{"operationId":"list","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSchema"}}}}},"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Listar webhooks de la key","tags":["Webhooks"]},"post":{"description":"Devuelve `signingSecret` una sola vez: guardalo para verificar la firma `Nodo-Signature`. Arranca desde ahora (no manda cambios anteriores).","operationId":"create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookDto"}}}},"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Crear un webhook","tags":["Webhooks"]}},"/v1/webhooks/{id}":{"patch":{"description":"URL, eventos o `active` (reactivar uno apagado por fallos).","operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookDto"}}}},"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Modificar un webhook","tags":["Webhooks"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Borrar un webhook","tags":["Webhooks"]}},"/v1/webhooks/{id}/test":{"post":{"description":"Manda un evento `ping` firmado y devuelve cómo respondió tu servidor.","operationId":"test","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Mandar un ping","tags":["Webhooks"]}},"/v1/webhooks/{id}/deliveries":{"get":{"description":"Estado, intentos y respuesta de tu servidor de las últimas 50 entregas.","operationId":"deliveries","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Últimas entregas","tags":["Webhooks"]}},"/v1/pedidos":{"get":{"description":"Ordenados por fecha de cambio. Cada pedido trae `version` y `actualizado`: aplicá solo si es más nuevo que lo que tenés.","operationId":"list","parameters":[{"name":"desde","required":false,"in":"query","description":"Pedidos que cambiaron desde esta fecha (ISO 8601). Sin `desde` ni `cursor`, todos.","schema":{"example":"2026-11-16T00:00:00-03:00","type":"string"}},{"name":"cursor","required":false,"in":"query","description":"`meta.nextCursor` de la página anterior (tiene prioridad sobre `desde`).","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Pedidos por página (1 a 100).","schema":{"default":50,"type":"number"}},{"name":"estado","required":false,"in":"query","description":"Solo los pedidos en este estado (filtra la página).","schema":{"enum":["pendiente_aprobacion","creado","enviado","rechazado","cancelado","fallido"],"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Pedidos que cambiaron desde una fecha","tags":["Pedidos"]}},"/v1/pedidos/{id}":{"get":{"description":"Por id o por número (`NODO-123`).","operationId":"get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Un pedido","tags":["Pedidos"]}},"/v1/pedidos/{id}/documentos/{documentId}":{"get":{"description":"La copia que NODO guardó del portal del distribuidor. Es el `pdf_url` de `facturas[]` y `remitos[]`; se pide con la misma API key.","operationId":"document","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"documentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"PDF de una factura o un remito del pedido","tags":["Pedidos"]}},"/v1/facturas":{"get":{"description":"Todas las que NODO encontró en los portales, unidas a un pedido (`pedido`) o sueltas (`pedido: null`). Cada una trae `version` y `actualizado`.","operationId":"list","parameters":[{"name":"desde","required":false,"in":"query","description":"Comprobantes que cambiaron desde esta fecha (ISO 8601). Sin `desde` ni `cursor`, todos.","schema":{"example":"2026-11-16T00:00:00-03:00","type":"string"}},{"name":"cursor","required":false,"in":"query","description":"`meta.nextCursor` de la página anterior (tiene prioridad sobre `desde`).","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Comprobantes por página (1 a 100).","schema":{"default":50,"type":"number"}},{"name":"pedido","required":false,"in":"query","description":"Solo los unidos a un pedido de NODO (`con`) o los sueltos (`sin`). Filtra la página.","schema":{"enum":["con","sin"],"type":"string"}},{"name":"distribuidor","required":false,"in":"query","description":"Solo de este distribuidor (`ELIT`, `NEW_BYTES`…). Filtra la página.","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Facturas que cambiaron desde una fecha","tags":["Facturas"]}},"/v1/facturas/{id}":{"get":{"operationId":"get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"Una factura","tags":["Facturas"]}},"/v1/facturas/{id}/pdf":{"get":{"description":"La copia guardada en NODO. Si `pdf_generado_por_nodo`, NODO lo armó con los datos oficiales (New Bytes no publica el original).","operationId":"pdf","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Parámetros inválidos o cursor que no corresponde a la consulta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"401":{"description":"Falta la key o el secret, no son válidos, o la key está revocada o vencida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"402":{"description":"La API de catálogo no está activa en el plan, o la suscripción está suspendida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"403":{"description":"IP no permitida o la key no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}},"429":{"description":"Límite de pedidos por minuto superado (ver Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorSchema"}}}}},"security":[{"ApiKey":[],"ApiSecret":[]},{"Basic":[]}],"summary":"PDF de la factura","tags":["Facturas"]}}},"info":{"title":"NODO — API de catálogo","description":"API de catálogo de NODO: el catálogo de tu comercio —todos tus distribuidores, con\ntus precios, tus impuestos y tu stock— para tu tienda online, tu ERP, tus listas de\nprecios o tus feeds.\n\n**Siempre al día y sin caídas.** NODO sincroniza tus distribuidores de forma\ncontinua y sirve siempre la última foto buena del catálogo. Si un distribuidor se\ncae o responde a medias, la API no: sigue respondiendo con lo último sincronizado y\nte avisa la frescura de cada oferta (`freshness.syncedAt`, `freshness.stale`).\n\n### Autenticación\nCada request lleva tu key y tu secret, de una de estas dos formas:\n- Headers `X-Api-Key: nodo_pk_…` y `X-Api-Secret: nodo_sk_…`\n- HTTP Basic: usuario = key, contraseña = secret\n\nEl secret se ve una sola vez al crear o rotar la key. Al rotar, el anterior sigue\nvaliendo 24 h para que cambies sin cortes. Los feeds usan un token de solo lectura\nen la URL.\n\n### Paginación\nLos listados son por cursor: usá `pagination.nextCursor` como `cursor` hasta que\n`hasMore` sea `false`. El cursor está atado al orden y a los filtros.\n\n### Límites\nCada key tiene un límite de pedidos por minuto (por defecto 120). Cada respuesta trae\n`X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset`; al pasarte\nrecibís `429` con `Retry-After`.\n\n### Errores\n`{ \"error\": { \"code\", \"message\", \"requestId\", \"docs\" } }`. El `code` es estable;\nel `requestId` (también en el header `X-Request-Id`) nos sirve para ayudarte.\n\n### Permisos de una key\n- `catalog:read`: Leer productos, ofertas y taxonomía\n- `changes:read`: Leer cambios incrementales\n- `export:read`: Exportar el catálogo (CSV, XLSX, JSON)\n- `feeds:read`: Feeds de Google Merchant y Meta\n- `webhooks:manage`: Administrar webhooks por API\n- `orders:read`: Leer pedidos y recibir sus avisos (solo The Gamer Shop)\n\n### Webhooks\nNODO te avisa los cambios por POST a tu URL (`type: \"catalog.changes\"`, hasta 100\ncambios por entrega), firmados con `Nodo-Signature: t=<unix>,v1=<hmac>` donde\n`hmac = HMAC-SHA256(\"<t>.<body>\", signingSecret)`. Respondé 2xx en menos de 10 s.\nReintentos: 1 min, 5 min, 30 min, 2 h, 6 h, 12 h y 24 h. Eventos:\n- `offer.created`: Entra un producto\n- `offer.updated`: Cambia un producto (cualquier dato)\n- `offer.removed`: Sale un producto\n- `price.changed`: Cambia un precio\n- `stock.changed`: Cambia el stock\n- `provider.sync_paused`: Un distribuidor pausó su sincronización\n- `provider.sync_resumed`: Un distribuidor volvió a sincronizar\n\nGuía completa con ejemplos: https://nodohub.app/developers","version":"1.0.0","contact":{"name":"NODO","url":"https://nodohub.app","email":""}},"tags":[],"servers":[{"url":"https://api.nodohub.app","description":"API de NODO"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Key pública (nodo_pk_…)"},"ApiSecret":{"type":"apiKey","in":"header","name":"X-Api-Secret","description":"Secret (nodo_sk_…)"},"Basic":{"type":"http","scheme":"basic","description":"Usuario = key, contraseña = secret"}},"schemas":{"MeSchema":{"type":"object","properties":{"key":{"type":"object","example":{"id":"…","name":"Tienda online","publicKey":"nodo_pk_…","scopes":["catalog:read"],"rateLimitPerMinute":120,"createdAt":"…","expiresAt":null}},"organization":{"type":"object","example":{"name":"Mi comercio","plan":"PRO"}},"config":{"type":"object","description":"Config efectiva de la key (con los valores por defecto completos)."},"catalog":{"type":"object","example":{"offers":18234,"products":9120,"providers":6,"catalogAt":"…"}}},"required":["key","organization","config","catalog"]},"ErrorBodySchema":{"type":"object","properties":{"code":{"type":"string","enum":["missing_credentials","invalid_credentials","key_revoked","key_expired","addon_required","subscription_suspended","ip_not_allowed","insufficient_scope","not_found","invalid_parameter","invalid_cursor","cursor_expired","feed_link_required","rate_limited","internal_error"],"example":"invalid_credentials","description":"Código estable para manejar el error en tu sistema."},"message":{"type":"string","example":"Faltan credenciales o no son válidas."},"requestId":{"type":"string","example":"req_4fK9Lm2QwErT8yUi"},"docs":{"type":"string","example":"https://nodohub.app/developers#errores"},"details":{"type":"object"}},"required":["code","message","requestId","docs"]},"ErrorSchema":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/ErrorBodySchema"}},"required":["error"]},"RefSchema":{"type":"object","properties":{"id":{"type":"string","example":"brd_9fK2LqP0aZxT"},"name":{"type":"string","example":"ASUS"}},"required":["id","name"]},"CategoryRefSchema":{"type":"object","properties":{"id":{"type":"string","example":"brd_9fK2LqP0aZxT"},"name":{"type":"string","example":"ASUS"},"path":{"example":["Placas de video"],"type":"array","items":{"type":"string"}}},"required":["id","name","path"]},"ImageSchema":{"type":"object","properties":{"url":{"type":"string"},"source":{"type":"string","enum":["provider","ai_suggested"],"description":"`ai_suggested`: la eligió la búsqueda de imágenes de NODO."}},"required":["url","source"]},"SpecsSchema":{"type":"object","properties":{"warranty":{"type":"object","nullable":true,"example":"36 meses"},"weight":{"type":"object","nullable":true,"example":{"value":1.2,"unit":"kg"}},"dimensions":{"type":"object","nullable":true,"example":{"height":4,"width":12,"length":23,"unit":"cm"}},"volume":{"type":"object","nullable":true}},"required":["warranty","weight","dimensions","volume"]},"AvailabilitySchema":{"type":"object","properties":{"inStock":{"type":"boolean"},"totalStock":{"type":"object","nullable":true,"example":34},"offers":{"type":"number","example":3}},"required":["inStock","totalStock","offers"]},"ProviderRefSchema":{"type":"object","properties":{"id":{"type":"string","example":"prv_3kT9xQ2mWvLp0aZr","description":"Id estable del distribuidor para esta organización."},"name":{"type":"string","example":"Proveedor 2","description":"Alias si la key oculta la identidad; si no, el nombre real."},"key":{"type":"string","example":"ELIT","description":"Solo con identidad visible."}},"required":["id","name"]},"StockSchema":{"type":"object","properties":{"quantity":{"type":"object","nullable":true,"example":12,"description":"`null` = el distribuidor no informa cantidad (hay stock)."},"status":{"type":"string","enum":["in_stock","low","out_of_stock","unknown"]},"minThresholdApplied":{"type":"number","example":2,"description":"Tu umbral: con esta cantidad o menos se informa 0."}},"required":["quantity","status","minThresholdApplied"]},"TaxSchema":{"type":"object","properties":{"type":{"type":"string","enum":["iva","internal","perception","other"],"example":"iva"},"label":{"type":"string","example":"IVA"},"percent":{"type":"object","nullable":true,"example":10.5,"description":"Alícuota en puntos. `null` si el distribuidor mandó un monto fijo."},"amount":{"type":"number","example":31.5,"description":"Monto unitario en la moneda de la respuesta."},"estimated":{"type":"boolean","description":"No vino del distribuidor: es la alícuota habitual de tu cuenta."}},"required":["type","label","percent","amount"]},"CostSchema":{"type":"object","properties":{"net":{"type":"number","example":300,"description":"Neto que cobra el distribuidor (con tu descuento de lista, sin margen)."},"taxes":{"type":"array","items":{"$ref":"#/components/schemas/TaxSchema"}},"gross":{"type":"number","example":340.5,"description":"Lo que te cuesta: neto + impuestos + percepciones."}},"required":["net","gross"]},"SaleSchema":{"type":"object","properties":{"net":{"type":"number","example":360,"description":"Neto con tu margen."},"taxes":{"description":"IVA e internos sobre el neto de venta. Las percepciones no se trasladan.","type":"array","items":{"$ref":"#/components/schemas/TaxSchema"}},"gross":{"type":"number","example":397.8,"description":"Precio de venta final (con el redondeo de la key)."},"markupPercent":{"type":"number","example":20}},"required":["net","gross","markupPercent"]},"PriceSchema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","ARS"],"example":"USD"},"cost":{"$ref":"#/components/schemas/CostSchema"},"sale":{"$ref":"#/components/schemas/SaleSchema"},"listSource":{"type":"string","enum":["api","list","base_list"],"description":"De dónde sale el precio: integración con el distribuidor, tu lista o la lista base del distribuidor."}},"required":["currency","listSource"]},"FreshnessSchema":{"type":"object","properties":{"syncedAt":{"type":"string","example":"2026-10-05T12:31:08.000Z","description":"Última vez que se sincronizó esta oferta."},"stale":{"type":"boolean","example":false,"description":"`true` si la sincronización de este distribuidor está atrasada."},"providerSync":{"type":"string","enum":["ok","paused","error"],"description":"Estado de la sincronización del distribuidor."}},"required":["syncedAt","stale","providerSync"]},"ProductSummarySchema":{"type":"object","properties":{"name":{"type":"string","example":"Placa de video ASUS Dual GeForce RTX 4060 OC 8GB"},"brand":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/RefSchema"}]},"category":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CategoryRefSchema"}]},"ean":{"type":"object","nullable":true,"example":"4711081976386"},"partNumber":{"type":"object","nullable":true,"example":"DUAL-RTX4060-O8G"},"imageUrl":{"type":"object","nullable":true,"description":"Foto principal."},"images":{"description":"Todas las fotos del producto: la principal primero y después la galería del distribuidor.","type":"array","items":{"type":"string"}}},"required":["name","brand","category","ean","partNumber","imageUrl","images"]},"OfferSchema":{"type":"object","properties":{"id":{"type":"string","example":"off_7Hq2Zk9LmXwR4tNc1aBv0e"},"productId":{"type":"string","example":"prd_2Lk9QwE5rTyU8iOp3aSd7f"},"provider":{"$ref":"#/components/schemas/ProviderRefSchema"},"sku":{"type":"object","nullable":true,"example":"90YV0JC0-M0NA00"},"externalId":{"type":"string","description":"Código del producto en el distribuidor. Solo con identidad visible."},"stock":{"$ref":"#/components/schemas/StockSchema"},"price":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/PriceSchema"}]},"freshness":{"$ref":"#/components/schemas/FreshnessSchema"},"updatedAt":{"type":"string","example":"2026-10-05T12:31:08.000Z"},"product":{"description":"Solo en /v1/offers: los datos básicos del producto.","allOf":[{"$ref":"#/components/schemas/ProductSummarySchema"}]}},"required":["id","productId","provider","sku","stock","price","freshness","updatedAt"]},"PriceRangeSchema":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"currency":{"type":"string","example":"USD"}},"required":["min","max","currency"]},"ProductSchema":{"type":"object","properties":{"id":{"type":"string","example":"prd_2Lk9QwE5rTyU8iOp3aSd7f","description":"Mismo producto en varios distribuidores = un id (por EAN o marca + part number)."},"name":{"type":"string"},"brand":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/RefSchema"}]},"category":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CategoryRefSchema"}]},"subcategory":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CategoryRefSchema"}]},"ean":{"type":"object","nullable":true},"partNumber":{"type":"object","nullable":true},"sku":{"type":"object","nullable":true},"description":{"type":"object","nullable":true},"longDescription":{"type":"object","nullable":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImageSchema"}},"specs":{"$ref":"#/components/schemas/SpecsSchema"},"tags":{"type":"array","items":{"type":"string"}},"links":{"type":"object","example":{"provider":[]},"description":"Links a la ficha del distribuidor (solo con identidad visible)."},"availability":{"$ref":"#/components/schemas/AvailabilitySchema"},"bestOffer":{"nullable":true,"description":"Con stock primero y después la más barata.","allOf":[{"$ref":"#/components/schemas/OfferSchema"}]},"priceRange":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/PriceRangeSchema"}]},"offers":{"type":"array","items":{"$ref":"#/components/schemas/OfferSchema"}},"updatedAt":{"type":"string"}},"required":["id","name","brand","category","subcategory","ean","partNumber","sku","description","longDescription","images","specs","tags","links","availability","bestOffer","priceRange","offers","updatedAt"]},"PaginationSchema":{"type":"object","properties":{"nextCursor":{"type":"object","nullable":true,"description":"Pasalo como `cursor` para la página siguiente. `null` = no hay más."},"hasMore":{"type":"boolean"},"limit":{"type":"number","example":100}},"required":["nextCursor","hasMore","limit"]},"FxSchema":{"type":"object","properties":{"source":{"type":"string","enum":["oficial","blue","mep","tarjeta","fixed"]},"rate":{"type":"object","nullable":true,"example":1450.5,"description":"Pesos por dólar (venta)."},"at":{"type":"object","nullable":true},"stale":{"type":"boolean","description":"`true` si la fuente no responde y se usa la última cotización buena."}},"required":["source","rate","at","stale"]},"MetaSchema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","ARS"]},"fx":{"$ref":"#/components/schemas/FxSchema"},"generatedAt":{"type":"string"},"catalogAt":{"type":"string","description":"Cuándo se armó la foto del catálogo que se está leyendo."}},"required":["currency","fx","generatedAt","catalogAt"]},"ProductListSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSchema"}},"pagination":{"$ref":"#/components/schemas/PaginationSchema"},"meta":{"$ref":"#/components/schemas/MetaSchema"}},"required":["data","pagination","meta"]},"ProductDetailSchema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ProductSchema"},"meta":{"$ref":"#/components/schemas/MetaSchema"}},"required":["data","meta"]},"OfferListSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OfferSchema"}},"pagination":{"$ref":"#/components/schemas/PaginationSchema"},"meta":{"$ref":"#/components/schemas/MetaSchema"}},"required":["data","pagination","meta"]},"OfferDetailSchema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OfferSchema"},"meta":{"$ref":"#/components/schemas/MetaSchema"}},"required":["data","meta"]},"PriceHistoryPointSchema":{"type":"object","properties":{"at":{"type":"string"},"costNet":{"type":"object","nullable":true,"description":"Costo neto en la moneda de la key (convertido a la cotización de hoy)."},"saleNet":{"type":"object","nullable":true,"description":"Neto con el margen actual."}},"required":["at","costNet","saleNet"]},"PriceHistorySchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PriceHistoryPointSchema"}},"meta":{"$ref":"#/components/schemas/MetaSchema"}},"required":["data","meta"]},"CountedRefSchema":{"type":"object","properties":{"id":{"type":"string","example":"brd_9fK2LqP0aZxT"},"name":{"type":"string","example":"ASUS"},"products":{"type":"number","example":152,"description":"Productos (agrupados) visibles para la key."}},"required":["id","name","products"]},"BrandsSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CountedRefSchema"}}},"required":["data"]},"CategoryNodeSchema":{"type":"object","properties":{"id":{"type":"string","example":"brd_9fK2LqP0aZxT"},"name":{"type":"string","example":"ASUS"},"products":{"type":"number","example":152,"description":"Productos (agrupados) visibles para la key."},"subcategories":{"type":"array","items":{"$ref":"#/components/schemas/CountedRefSchema"}}},"required":["id","name","products","subcategories"]},"CategoriesSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CategoryNodeSchema"}}},"required":["data"]},"ProviderStatusSchema":{"type":"object","properties":{"id":{"type":"string","example":"prv_3kT9xQ2mWvLp0aZr","description":"Id estable del distribuidor para esta organización."},"name":{"type":"string","example":"Proveedor 2","description":"Alias si la key oculta la identidad; si no, el nombre real."},"key":{"type":"string","example":"ELIT","description":"Solo con identidad visible."},"offers":{"type":"number","example":1834,"description":"Ofertas visibles para la key."},"lastSyncedAt":{"type":"object","nullable":true},"status":{"type":"string","enum":["ok","paused","error"]},"stale":{"type":"boolean"}},"required":["id","name","offers","lastSyncedAt","status","stale"]},"ProvidersSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderStatusSchema"}}},"required":["data"]},"FxListSchema":{"type":"object","properties":{"rates":{"type":"object","example":{"oficial":1450.5,"blue":1495,"mep":1480.2,"tarjeta":1885.6}},"at":{"type":"object","nullable":true},"stale":{"type":"boolean"},"key":{"description":"La que usa esta key.","allOf":[{"$ref":"#/components/schemas/FxSchema"}]}},"required":["rates","at","stale","key"]},"ChangeSchema":{"type":"object","properties":{"id":{"type":"string","example":"18342"},"type":{"type":"string","enum":["offer.created","offer.updated","offer.removed","provider.sync_paused","provider.sync_resumed"]},"at":{"type":"string"},"changed":{"example":["price","stock"],"description":"En offer.updated: qué cambió (`price`, `stock`, `product`).","type":"array","items":{"type":"string"}},"offerId":{"type":"string"},"productId":{"type":"string"},"offer":{"description":"La oferta como la ves ahora (created/updated).","allOf":[{"$ref":"#/components/schemas/OfferSchema"}]},"provider":{"$ref":"#/components/schemas/ProviderRefSchema"}},"required":["id","type","at"]},"ChangesPaginationSchema":{"type":"object","properties":{"nextCursor":{"type":"string","description":"Guardalo y usalo en la próxima consulta. Siempre viene, aunque no haya cambios."},"hasMore":{"type":"boolean"},"limit":{"type":"number"}},"required":["nextCursor","hasMore","limit"]},"ChangesSchema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChangeSchema"}},"pagination":{"$ref":"#/components/schemas/ChangesPaginationSchema"},"meta":{"type":"object"}},"required":["data","pagination","meta"]},"WebhookSchema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","example":"https://mi-tienda.com/webhooks/nodo"},"events":{"example":["price.changed","stock.changed"],"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"consecutiveFailures":{"type":"number"},"disabledAt":{"type":"object","nullable":true},"disabledReason":{"type":"object","nullable":true},"createdAt":{"type":"string"},"lastDelivery":{"type":"object","nullable":true}},"required":["id","url","events","active","consecutiveFailures","disabledAt","disabledReason","createdAt","lastDelivery"]},"CreateWebhookDto":{"type":"object","properties":{"url":{"type":"string","example":"https://mi-tienda.com/webhooks/nodo","description":"https obligatorio."},"events":{"type":"array","example":["price.changed","stock.changed","offer.removed"],"items":{"type":"string","enum":["offer.created","offer.updated","offer.removed","price.changed","stock.changed","provider.sync_paused","provider.sync_resumed","pedido.creado","pedido.actualizado","pedido.cancelado","pedido.facturado","factura.nueva","factura.actualizada"]}}},"required":["url","events"]},"UpdateWebhookDto":{"type":"object","properties":{"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["offer.created","offer.updated","offer.removed","price.changed","stock.changed","provider.sync_paused","provider.sync_resumed","pedido.creado","pedido.actualizado","pedido.cancelado","pedido.facturado","factura.nueva","factura.actualizada"]}},"active":{"type":"boolean","description":"`true` reactiva un webhook apagado por fallos."}}}}},"externalDocs":{"description":"Guía y ejemplos","url":"https://nodohub.app/developers"}}