Gelato MCP by usefulapi
Browse the Gelato catalog, prices, orders and shipping; quote, create draft orders and products.
¿Debería usar esto?
Calidad y seguridad
B
Hallazgos (7)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'gelato_get_template' description contains placeholder texten gelato_get_template
- MEDIUMTool 'gelato_create_product_from_template' description contains placeholder texten gelato_create_product_from_template
- LOWTool 'gelato_check_stock' description lacks action verben gelato_check_stock
- LOWTool 'gelato_create_product_from_template' name length outside 3-30 rangeen gelato_create_product_from_template
- INFOTool description contains placeholder or incomplete texten gelato_get_template
- INFOTool description contains placeholder or incomplete texten gelato_create_product_from_template
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~7,145Tokens (definiciones de herramientas)
~3.1 KBTamaño de respuesta típico
Impacto significativo en la atención (5.58% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"gelato": {
"url": "https://gelato.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://gelato.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (19)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢gelato_list_catalogs
List Gelato's product catalogs (posters, cards, t-shirts, mugs, photo books, ...) with their catalogUid and title. Start here to find products. GET product.gelatoapis.com/v3/catalogs.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_catalog(catalog_uid)
One catalog with the attributes that define its products (e.g. PaperFormat, PaperType, ColorType) and each attribute's possible values. Use them as attribute_filters in gelato_search_products. GET /v3/catalogs/{catalogUid}.
Esquema de entrada
{
"type": "object",
"properties": {
"catalog_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Catalog UID, e.g. \"posters\" (from gelato_list_catalogs)."
}
},
"required": [
"catalog_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_search_products(catalog_uid, attribute_filters, limit, offset)
List the products of a catalog, optionally filtered by attribute values, with each product's productUid, attributes, weight and dimensions, plus hit counts per attribute value. POST /v3/catalogs/{catalogUid}/products:search.
Esquema de entrada
{
"type": "object",
"properties": {
"catalog_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Catalog UID, e.g. \"posters\"."
},
"attribute_filters": {
"description": "Attribute name → accepted values, e.g. {\"Orientation\":[\"hor\"],\"PaperFormat\":[\"A4\",\"A3\"]} (names and values from gelato_get_catalog).",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"catalog_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_product(product_uid)
One catalog product by productUid: attributes, weight, supported and unsupported countries, whether it is printable or stockable, and valid page counts for multi-page products. GET /v3/products/{productUid}.
Esquema de entrada
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products)."
}
},
"required": [
"product_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_product_prices(product_uid, country, currency, page_count)
Gelato's production prices of a product for every quantity tier, optionally for one destination country and currency. page_count is required for multi-page products. Shipping is not included (use gelato_quote_order). GET /v3/products/{productUid}/prices.
Esquema de entrada
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID."
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"page_count": {
"description": "Page count, required for multi-page products.",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"product_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_cover_dimensions(product_uid, page_count)
Cover layout of a multi-page product (photo book, brochure) in millimetres: spine, front, back, bleed and wraparound areas, for designing the cover file. GET /v3/products/{productUid}/cover-dimensions.
Esquema de entrada
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID of a multi-page product."
},
"page_count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "Total page count including covers (see validPageCounts in gelato_get_product)."
}
},
"required": [
"product_uid",
"page_count"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_check_stock(product_uids)
Stock status of stockable products per stock region (US-CA, EU, UK, OC, AS, SA, ROW): in-stock, out-of-stock-replenishable (with a replenishment date), out-of-stock, non-stockable or not-supported. POST /v3/stock/region-availability.
Esquema de entrada
{
"type": "object",
"properties": {
"product_uids": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID."
},
"description": "Product UIDs to check (1-250)."
}
},
"required": [
"product_uids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_list_shipment_methods(country)
Gelato's shipment methods (shipmentMethodUid, name, type normal/express/pallet, tracking, business/private, supported destination countries), optionally only those for one destination country. GET shipment.gelatoapis.com/v1/shipment-methods.
Esquema de entrada
{
"type": "object",
"properties": {
"country": {
"description": "Only methods that deliver to this 2-letter ISO country code.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_search_orders(search, order_types, fulfillment_statuses, financial_statuses, countries, ...)
Search orders and drafts, newest first: id, your reference ids, order type, fulfillment and financial status, channel, store, country, currency, totals and dates. Filter by status, type, country, channel, store, reference, date range or free text (recipient name or order reference). POST /v4/orders:search.
Esquema de entrada
{
"type": "object",
"properties": {
"search": {
"description": "Free text matched against the recipient's first or last name and orderReferenceId.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_types": {
"description": "Only these order types.",
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"order",
"draft"
]
}
},
"fulfillment_statuses": {
"description": "Only these fulfillment statuses.",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"enum": [
"created",
"passed",
"failed",
"canceled",
"printed",
"shipped",
"draft",
"pending_approval",
"not_connected",
"on_hold"
]
}
},
"financial_statuses": {
"description": "Only these financial statuses.",
"minItems": 1,
"maxItems": 9,
"type": "array",
"items": {
"type": "string",
"enum": [
"draft",
"pending",
"invoiced",
"to_be_invoiced",
"paid",
"canceled",
"partially_refunded",
"refunded",
"refused"
]
}
},
"countries": {
"description": "Only orders shipping to these countries (2-letter ISO codes).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"currencies": {
"description": "Only orders in these currencies.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
}
},
"channels": {
"description": "Only orders from these channels (ui, api, shopify, etsy).",
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"ui",
"api",
"shopify",
"etsy"
]
}
},
"store_ids": {
"description": "Only orders from these e-commerce store ids.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
}
},
"ids": {
"description": "Only these Gelato order ids.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id."
}
},
"order_reference_ids": {
"description": "Only orders with these orderReferenceIds.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your order reference id."
}
},
"start_date": {
"description": "Only orders ordered or created on or after this ISO 8601 date-time (e.g. 2026-10-01T00:00:00Z).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?(Z|[+-](\\d{2}):(\\d{2})))?$"
},
"end_date": {
"description": "Only orders ordered or created on or before this ISO 8601 date-time.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?(Z|[+-](\\d{2}):(\\d{2})))?$"
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_order(order_id)
One order by Gelato order id: type (order/draft), fulfillment and financial status, items with their files and statuses, shipment with packages and tracking codes/URLs, shipping address, receipts and totals. GET /v4/orders/{orderId}.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id (from gelato_search_orders)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_quote_order(order_reference_id, customer_reference_id, currency, recipient, products, ...)
Price an order before placing it: product prices and the available shipment methods (shipmentMethodUid, price, min/max delivery days and dates) per fulfillment facility, for a recipient address. Nothing is created or charged. Pass a returned shipmentMethodUid to gelato_create_order. POST /v4/orders:quote.
Esquema de entrada
{
"type": "object",
"properties": {
"order_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your order reference id for the quote."
},
"customer_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your customer reference id."
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"recipient": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient first name (Gelato allows 25 characters)."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient last name (Gelato allows 25 characters)."
},
"company_name": {
"description": "Company name (max 60 characters).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"address_line1": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Street and number (Gelato allows 35 characters)."
},
"address_line2": {
"description": "Second address line (Gelato allows 35 characters).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "City (Gelato allows 30 characters)."
},
"post_code": {
"description": "Postal code (required where the country uses them).",
"type": "string",
"minLength": 1,
"maxLength": 15
},
"state": {
"description": "State/province code, required for US, CA and AU (e.g. NY).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"phone": {
"description": "Recipient phone number.",
"type": "string",
"minLength": 1,
"maxLength": 25
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Recipient email (required by Gelato; used for delivery notifications)."
},
"is_business": {
"description": "Brazil only: true if the recipient is a company (then state_tax_id and registration_state_code apply).",
"type": "boolean"
},
"federal_tax_id": {
"description": "Brazil only, required there: CPF (person) or CNPJ (company).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"state_tax_id": {
"description": "Brazil only: the company's state tax id (Inscrição Estadual).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"registration_state_code": {
"description": "Brazil only: the state code where the company is registered.",
"type": "string",
"minLength": 1,
"maxLength": 10
}
},
"required": [
"first_name",
"last_name",
"address_line1",
"city",
"country",
"email"
],
"additionalProperties": false,
"description": "Delivery address the quote is for."
},
"products": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your id for this line, unique within the order."
},
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products or a store product variant)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Quantity, at least 1."
},
"files": {
"description": "Print files (required for printable products only).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Print area: \"default\" (the primary area, e.g. the front of apparel), \"front\", \"back\", or an embroidery position. Default \"default\".",
"type": "string",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9_-]+$"
},
"url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public URL Gelato downloads the file from (PDF, PNG, TIFF, SVG or JPEG)."
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"page_count": {
"description": "Page count, multi-page products only (covers included).",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"item_reference_id",
"product_uid",
"quantity"
],
"additionalProperties": false
},
"description": "Products to quote."
},
"allow_multiple_quotes": {
"description": "Default true: one quote per fulfillment facility when one facility cannot make everything. False: one combined quote.",
"type": "boolean"
}
},
"required": [
"order_reference_id",
"customer_reference_id",
"currency",
"recipient",
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_create_order(order_type, order_reference_id, customer_reference_id, currency, items, ...)
Create an order. By default it is a DRAFT: nothing is produced or charged until it is submitted with gelato_submit_draft_order (or in the dashboard). With order_type "order" Gelato starts production and charges the account right away. Shipment: a shipmentMethodUid from gelato_quote_order, or "normal"/"standard"/"express"; omitted = the cheapest. POST /v4/orders.
Esquema de entrada
{
"type": "object",
"properties": {
"order_type": {
"description": "\"draft\" (default; review first) or \"order\" (produced and charged immediately).",
"type": "string",
"enum": [
"draft",
"order"
]
},
"order_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your internal order id."
},
"customer_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your internal customer id."
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your id for this line, unique within the order."
},
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products or a store product variant)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Quantity, at least 1."
},
"files": {
"description": "Print files (required for printable products only).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Print area: \"default\" (the primary area, e.g. the front of apparel), \"front\", \"back\", or an embroidery position. Default \"default\".",
"type": "string",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9_-]+$"
},
"url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public URL Gelato downloads the file from (PDF, PNG, TIFF, SVG or JPEG)."
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"page_count": {
"description": "Page count, multi-page products only (covers included).",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"item_reference_id",
"product_uid",
"quantity"
],
"additionalProperties": false
},
"description": "Line items."
},
"shipping_address": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient first name (Gelato allows 25 characters)."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient last name (Gelato allows 25 characters)."
},
"company_name": {
"description": "Company name (max 60 characters).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"address_line1": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Street and number (Gelato allows 35 characters)."
},
"address_line2": {
"description": "Second address line (Gelato allows 35 characters).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "City (Gelato allows 30 characters)."
},
"post_code": {
"description": "Postal code (required where the country uses them).",
"type": "string",
"minLength": 1,
"maxLength": 15
},
"state": {
"description": "State/province code, required for US, CA and AU (e.g. NY).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"phone": {
"description": "Recipient phone number.",
"type": "string",
"minLength": 1,
"maxLength": 25
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Recipient email (required by Gelato; used for delivery notifications)."
},
"is_business": {
"description": "Brazil only: true if the recipient is a company (then state_tax_id and registration_state_code apply).",
"type": "boolean"
},
"federal_tax_id": {
"description": "Brazil only, required there: CPF (person) or CNPJ (company).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"state_tax_id": {
"description": "Brazil only: the company's state tax id (Inscrição Estadual).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"registration_state_code": {
"description": "Brazil only: the state code where the company is registered.",
"type": "string",
"minLength": 1,
"maxLength": 10
}
},
"required": [
"first_name",
"last_name",
"address_line1",
"city",
"country",
"email"
],
"additionalProperties": false,
"description": "Delivery address."
},
"shipment_method_uid": {
"description": "A shipmentMethodUid from gelato_quote_order, or \"normal\", \"standard\", \"express\". Several values may be given separated by commas (no spaces). Omitted = cheapest.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9_.:-]+(,[A-Za-z0-9_.:-]+)*$"
},
"metadata": {
"description": "Up to 20 key/value pairs stored on the order.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"value": {
"type": "string",
"maxLength": 100
}
},
"required": [
"key",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"order_reference_id",
"customer_reference_id",
"currency",
"items",
"shipping_address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_submit_draft_order(order_id)
Convert a DRAFT order into a regular order: Gelato starts production and charges the account. Items stay as they are. Only drafts can be submitted. PATCH /v4/orders/{orderId} {"orderType":"order"}.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id of a draft order."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_cancel_order(order_id)
Cancel an order before production. Gelato refuses (HTTP 409) once any item is printed or the order has shipped. This cannot be undone. POST /v4/orders/{orderId}:cancel.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_delete_draft_order(order_id)
Permanently delete a DRAFT order (regular orders cannot be deleted; cancel them instead). DELETE /v4/orders/{orderId}.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id of a draft order."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_list_store_products(store_id, order_by, order, limit, offset)
Products of a connected e-commerce store (Shopify, Etsy, WooCommerce, ...) as Gelato knows them: id, title, status (created/publishing/publishing_error/active), external id, variants with their productUid, preview images and dates. The store id is in the Gelato dashboard URL of the store and on its orders (storeId). GET ecommerce.gelatoapis.com/v1/stores/{storeId}/products.
Esquema de entrada
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"order_by": {
"description": "Sort field (default createdAt).",
"type": "string",
"enum": [
"createdAt",
"updatedAt"
]
},
"order": {
"description": "Sort direction (default desc).",
"type": "string",
"enum": [
"desc",
"asc"
]
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"store_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_store_product(store_id, product_id)
One product of a connected store: title, description, status, variants (with productUid and external ids), options, preview and publishing state. GET /v1/stores/{storeId}/products/{productId}.
Esquema de entrada
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"product_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Store product id (from gelato_list_store_products)."
}
},
"required": [
"store_id",
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_template(template_id)
A product template made in the Gelato dashboard: title, description, preview, and its variants (id, title, productUid; pass the variant id as template_variant_id) with their image placeholders (names to fill in gelato_create_product_from_template). GET /v1/templates/{templateId}.
Esquema de entrada
{
"type": "object",
"properties": {
"template_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Template id (Gelato dashboard → the template's URL)."
}
},
"required": [
"template_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_create_product_from_template(store_id, template_id, title, description, visible_in_online_store, ...)
Create a product in a connected store from a template, with your own images in the template's placeholders. Gelato creates the product, then publishes variants and mockups in the background (track it with gelato_get_store_product). Hidden in the online store unless visible_in_online_store is true. POST /v1/stores/{storeId}/products:create-from-template.
Esquema de entrada
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"template_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Template id (see gelato_get_template)."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Product title."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "Product description (HTML allowed by most stores)."
},
"visible_in_online_store": {
"description": "Show the product in the online store (default false).",
"type": "boolean"
},
"sales_channels": {
"description": "Sales channels: \"web\" (default) or \"global\" (Shopify Point of Sale).",
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"web",
"global"
]
}
},
"tags": {
"description": "Product tags, at most 13 (Etsy stores: 20 characters each).",
"minItems": 1,
"maxItems": 13,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"product_type": {
"description": "Product type shown in the store.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"vendor": {
"description": "Vendor shown in the store.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"variants": {
"description": "Variants to create (omit for all template variants), each with the images for its placeholders.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"template_variant_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "The variant id (variants[].id) from gelato_get_template."
},
"image_placeholders": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Placeholder (layer) name from the template."
},
"file_url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public image URL (jpg, jpeg, png or pdf)."
},
"fit_method": {
"description": "\"slice\" (default: fill and crop) or \"meet\" (fit the whole image).",
"type": "string",
"enum": [
"slice",
"meet"
]
}
},
"required": [
"name",
"file_url"
],
"additionalProperties": false
}
}
},
"required": [
"template_variant_id"
],
"additionalProperties": false
}
}
},
"required": [
"store_id",
"template_id",
"title",
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada19 herramientas