{
    "info": {
        "_postman_id": "e336f244-6dc2-45ea-837a-1301de31a280",
        "name": "Guper · Catalog",
        "description": "Guper Catalog API reference. Generated from the documentation portal.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "item": [
        {
            "name": "Brand",
            "item": [
                {
                    "name": "By-entity",
                    "item": [
                        {
                            "name": "List refs of many Brands",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand-external-ref/by-brand",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand-external-ref",
                                        "by-brand"
                                    ]
                                },
                                "description": "Same reverse lookup as `by-brand/{brandId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the brand the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/brand-external-ref/by-brand",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "brand-external-ref",
                                                "by-brand"
                                            ]
                                        },
                                        "description": "Same reverse lookup as `by-brand/{brandId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the brand the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\",\"id\":42},{\"refId\":\"11-2\",\"source\":\"pos\",\"id\":42},{\"refId\":\"9-22\",\"source\":\"pos\",\"id\":51}]"
                                }
                            ]
                        },
                        {
                            "name": "List refs of a Brand",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand-external-ref/by-brand/{{brandId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand-external-ref",
                                        "by-brand",
                                        "{{brandId}}"
                                    ]
                                },
                                "description": "Lists every external `refId` mapped to one brand, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/brand/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the brand has no mapping. Does not 404 on an unknown id."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/brand-external-ref/by-brand/{{brandId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "brand-external-ref",
                                                "by-brand",
                                                "{{brandId}}"
                                            ]
                                        },
                                        "description": "Lists every external `refId` mapped to one brand, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/brand/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the brand has no mapping. Does not 404 on an unknown id."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\"},{\"refId\":\"11-2\",\"source\":\"pos\"}]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "By-interface",
                    "item": [
                        {
                            "name": "Link Brand ref to existing entity",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Links this `refId` to an existing entity (passed by `brandId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"brandId\": 42\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Links this `refId` to an existing entity (passed by `brandId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"brandId\": 42\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_linked\":true}"
                                }
                            ]
                        },
                        {
                            "name": "List Brand refs",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand"
                                    ]
                                },
                                "description": "Lists every external ref for `brand` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand"
                                            ]
                                        },
                                        "description": "Lists every external ref for `brand` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}},{\"id\":89,\"name\":\"Adidas\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-ADIDAS-001\"}}]"
                                }
                            ]
                        },
                        {
                            "name": "Get Brand by ref",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Brand ref",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"success\":true}"
                                }
                            ]
                        },
                        {
                            "name": "Bulk resolve Brand refs",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/_resolve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand",
                                        "_resolve"
                                    ]
                                },
                                "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand/_resolve",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand",
                                                "_resolve"
                                            ]
                                        },
                                        "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"VTEX-NIKE-001\":42,\"VTEX-ADIDAS-001\":89,\"FAKE-DOES-NOT-EXIST\":null}"
                                }
                            ]
                        },
                        {
                            "name": "Create or get Brand ref",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "brand"
                                    ]
                                },
                                "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/brand",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "brand"
                                            ]
                                        },
                                        "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_created\":true}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create Brand",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/brand",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "brand"
                            ]
                        },
                        "description": "Creates a new brand under the current organization. Only `name` is accepted; the brand id is generated by the database and returned in the response.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"PoloPlay\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Brand created",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand"
                                    ]
                                },
                                "description": "Creates a new brand under the current organization. Only `name` is accepted; the brand id is generated by the database and returned in the response.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"PoloPlay\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"PoloPlay\",\n    \"organization\": \"acme\",\n    \"id\": 124,\n    \"dateTime\": \"2024-08-23T20:53:41-03:00\"\n}"
                        },
                        {
                            "name": "Missing required field `name`",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand"
                                    ]
                                },
                                "description": "Creates a new brand under the current organization. Only `name` is accepted; the brand id is generated by the database and returned in the response.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"PoloPlay\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"error\": \"Json parameters are missing\"\n}"
                        }
                    ]
                },
                {
                    "name": "Remove Brand",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/brand/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "brand",
                                "{{id}}"
                            ]
                        },
                        "description": "Deletes a brand by id. The id goes in the URL; no body is required."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Deletes a brand by id. The id goes in the URL; no body is required."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 123,\n    \"dateTime\": \"2023-08-23T20:55:12-03:00\"\n}"
                        }
                    ]
                },
                {
                    "name": "Update Brand",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/brand/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "brand",
                                "{{id}}"
                            ]
                        },
                        "description": "Updates an existing brand. The id goes in the URL; the body carries the fields to change. Only `name` is editable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Alfani\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Brand updated",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing brand. The id goes in the URL; the body carries the fields to change. Only `name` is editable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Alfani\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"Alfani\",\n    \"id\": 123,\n    \"organization\": \"acme\",\n    \"dateTime\": \"2024-08-23T20:54:23-03:00\"\n}"
                        },
                        {
                            "name": "Body is not valid JSON",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/brand/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "brand",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing brand. The id goes in the URL; the body carries the fields to change. Only `name` is editable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Alfani\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"error\": \"Body is not a json\"\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Category",
            "item": [
                {
                    "name": "By-entity",
                    "item": [
                        {
                            "name": "List refs of many Categories",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category-external-ref/by-category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category-external-ref",
                                        "by-category"
                                    ]
                                },
                                "description": "Same reverse lookup as `by-category/{categoryId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the category the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/category-external-ref/by-category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "category-external-ref",
                                                "by-category"
                                            ]
                                        },
                                        "description": "Same reverse lookup as `by-category/{categoryId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the category the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\",\"id\":42},{\"refId\":\"11-2\",\"source\":\"pos\",\"id\":42},{\"refId\":\"9-22\",\"source\":\"pos\",\"id\":51}]"
                                }
                            ]
                        },
                        {
                            "name": "List refs of a Category",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category-external-ref/by-category/{{categoryId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category-external-ref",
                                        "by-category",
                                        "{{categoryId}}"
                                    ]
                                },
                                "description": "Lists every external `refId` mapped to one category, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/category/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the category has no mapping. Does not 404 on an unknown id."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/category-external-ref/by-category/{{categoryId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "category-external-ref",
                                                "by-category",
                                                "{{categoryId}}"
                                            ]
                                        },
                                        "description": "Lists every external `refId` mapped to one category, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/category/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the category has no mapping. Does not 404 on an unknown id."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\"},{\"refId\":\"11-2\",\"source\":\"pos\"}]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "By-interface",
                    "item": [
                        {
                            "name": "Link Category ref to existing entity",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Links this `refId` to an existing entity (passed by `categoryId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"categoryId\": 42\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Links this `refId` to an existing entity (passed by `categoryId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"categoryId\": 42\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_linked\":true}"
                                }
                            ]
                        },
                        {
                            "name": "List Category refs",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category"
                                    ]
                                },
                                "description": "Lists every external ref for `category` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category"
                                            ]
                                        },
                                        "description": "Lists every external ref for `category` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}},{\"id\":89,\"name\":\"Adidas\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-ADIDAS-001\"}}]"
                                }
                            ]
                        },
                        {
                            "name": "Get Category by ref",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Category ref",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"success\":true}"
                                }
                            ]
                        },
                        {
                            "name": "Bulk resolve Category refs",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/_resolve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category",
                                        "_resolve"
                                    ]
                                },
                                "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category/_resolve",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category",
                                                "_resolve"
                                            ]
                                        },
                                        "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"VTEX-NIKE-001\":42,\"VTEX-ADIDAS-001\":89,\"FAKE-DOES-NOT-EXIST\":null}"
                                }
                            ]
                        },
                        {
                            "name": "Create or get Category ref",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "category"
                                    ]
                                },
                                "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "category"
                                            ]
                                        },
                                        "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_created\":true}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create Category",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "category"
                            ]
                        },
                        "description": "Creates a new category under the current organization. Categories form a tree: pass `parent` (the id of the parent category) to nest the new entry; omit it to create a root-level category.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Root-level category created",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category"
                                    ]
                                },
                                "description": "Creates a new category under the current organization. Categories form a tree: pass `parent` (the id of the parent category) to nest the new entry; omit it to create a root-level category.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"Shirts\",\n    \"organization\": \"acme\",\n    \"id\": 133,\n    \"dateTime\": \"2024-08-23T20:27:39-03:00\"\n}"
                        },
                        {
                            "name": "Child category created (with parent)",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category"
                                    ]
                                },
                                "description": "Creates a new category under the current organization. Categories form a tree: pass `parent` (the id of the parent category) to nest the new entry; omit it to create a root-level category.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"Polos\",\n    \"parent\": 133,\n    \"organization\": \"acme\",\n    \"id\": 139,\n    \"dateTime\": \"2024-08-23T20:31:58-03:00\"\n}"
                        },
                        {
                            "name": "Missing required field `name`",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category"
                                    ]
                                },
                                "description": "Creates a new category under the current organization. Categories form a tree: pass `parent` (the id of the parent category) to nest the new entry; omit it to create a root-level category.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"error\": \"Json parameters are missing\"\n}"
                        }
                    ]
                },
                {
                    "name": "List Categorys",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "category"
                            ]
                        },
                        "description": "Returns a paginated list of categories."
                    },
                    "response": [
                        {
                            "name": "Paginated list",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category"
                                    ]
                                },
                                "description": "Returns a paginated list of categories."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        { \"id\": 20, \"name\": \"Smartphones\", \"refId\": \"cat-001\" },\n        { \"id\": 21, \"name\": \"Accessories\", \"refId\": \"cat-002\" }\n    ],\n    \"total\": 2,\n    \"pagination\": { \"entries\": 20, \"currentPage\": 1, \"totalPages\": 1 }\n}"
                        }
                    ]
                },
                {
                    "name": "Get Category",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{refId}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "category",
                                "{{refId}}"
                            ]
                        },
                        "description": "### Retrieve Category Details\n\nThis endpoint retrieves the details of a specific category by providing the reference ID in the URL path.\n\n#### Request\n\n- Method: GET\n    \n- URL: `{{scheme}}://{{account}}.{{environment}}/api/catalog/category/:refId`\n    \n- Path Parameters:\n    \n    - `refId`: The reference ID of the category to retrieve."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "### Retrieve Category Details\n\nThis endpoint retrieves the details of a specific category by providing the reference ID in the URL path.\n\n#### Request\n\n- Method: GET\n    \n- URL: `{{scheme}}://{{account}}.{{environment}}/api/catalog/category/:refId`\n    \n- Path Parameters:\n    \n    - `refId`: The reference ID of the category to retrieve."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Remove Category",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": ""
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "category",
                                "{{id}}"
                            ]
                        },
                        "description": "Deletes a category by id. The id goes in the URL; no body is required."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": ""
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Deletes a category by id. The id goes in the URL; no body is required."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 1329,\n    \"dateTime\": \"2023-08-23T20:36:45-03:00\"\n}"
                        }
                    ]
                },
                {
                    "name": "Update Category",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "category",
                                "{{id}}"
                            ]
                        },
                        "description": "Updates an existing category. The id goes in the URL; the body carries the fields to change. Both `name` and `parent` are editable — pass `parent` to move the category in the tree, or send `null` to detach it back to root level.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Category updated",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing category. The id goes in the URL; the body carries the fields to change. Both `name` and `parent` are editable — pass `parent` to move the category in the tree, or send `null` to detach it back to root level.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"Polos\",\n    \"parent\": 133,\n    \"id\": 139,\n    \"organization\": \"acme\",\n    \"dateTime\": \"2024-08-23T20:41:20-03:00\"\n}"
                        },
                        {
                            "name": "Body is not valid JSON",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/category/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "category",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing category. The id goes in the URL; the body carries the fields to change. Both `name` and `parent` are editable — pass `parent` to move the category in the tree, or send `null` to detach it back to root level.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Polos\",\n    \"parent\": 133\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"error\": \"Body is not a json\"\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Collection",
            "item": [
                {
                    "name": "SKU",
                    "item": [
                        {
                            "name": "Map Skus to collections",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/collection/query/by/{{interface}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "collection",
                                        "query",
                                        "by",
                                        "{{interface}}"
                                    ]
                                },
                                "description": "Given a list of SKU IDs, returns which collections (in the given interface) each SKU belongs to.\nA SKU matches a collection when:\n- it appears as an explicit SKU in `collection_sku`,\n- it falls inside a numeric range in `collection_sku_ranges` (`sku_start` <= sku <= `sku_end`),\n- it matches a LIKE pattern in `collection_sku_pattern` (e.g. `ot%`, `%ot`, `%ot%`, case-insensitive),\n- or the collection has no SKU/range/pattern declared for that interface (empty-collection fallback: such collections are returned for every SKU).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "[\r\n    \"OT123\", \"abc\", \"550\"\r\n]",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/collection/query/by/{{interface}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "collection",
                                                "query",
                                                "by",
                                                "{{interface}}"
                                            ]
                                        },
                                        "description": "Given a list of SKU IDs, returns which collections (in the given interface) each SKU belongs to.\nA SKU matches a collection when:\n- it appears as an explicit SKU in `collection_sku`,\n- it falls inside a numeric range in `collection_sku_ranges` (`sku_start` <= sku <= `sku_end`),\n- it matches a LIKE pattern in `collection_sku_pattern` (e.g. `ot%`, `%ot`, `%ot%`, case-insensitive),\n- or the collection has no SKU/range/pattern declared for that interface (empty-collection fallback: such collections are returned for every SKU).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "[\r\n    \"OT123\", \"abc\", \"550\"\r\n]",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"OT123\": {\n        \"id\": \"OT123\",\n        \"collection\": [\n            2,\n            17\n        ]\n    },\n    \"abc\": {\n        \"id\": \"abc\",\n        \"collection\": [\n            2\n        ]\n    },\n    \"550\": {\n        \"id\": \"550\",\n        \"collection\": [\n            2,\n            9\n        ]\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Update Collection SKUs",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Use `text/plain` — the body is a raw semicolon-separated string, not JSON."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/collection/{{id}}/skus/by/{{interface}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "collection",
                                        "{{id}}",
                                        "skus",
                                        "by",
                                        "{{interface}}"
                                    ]
                                },
                                "description": "Replaces the SKU set of a collection for a given interface. The body is a plain semicolon-separated string (NOT JSON). Each token is one of:\n- exact SKU: `sku-123`\n- numeric range: `start:end` (e.g. `500:600`)\n- LIKE pattern: contains `%` or `_` (e.g. `ot%`, `%ot`, `%ot%`). Patterns are stored lowercased and matched case-insensitively.\n\nToken resolution order: pattern (`%`/`_`) → range (`:`) → exact. A token containing `%` is always treated as pattern, even if it also contains `:`.\n\nThis endpoint is \"replace all\": existing SKUs/ranges/patterns of the (collection, interface) pair are deleted before the new tokens are inserted.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "ot%; %ot; sku-exato-1; 500:600",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "SKU set replaced successfully",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Use `text/plain` — the body is a raw semicolon-separated string, not JSON."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/collection/{{id}}/skus/by/{{interface}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "collection",
                                                "{{id}}",
                                                "skus",
                                                "by",
                                                "{{interface}}"
                                            ]
                                        },
                                        "description": "Replaces the SKU set of a collection for a given interface. The body is a plain semicolon-separated string (NOT JSON). Each token is one of:\n- exact SKU: `sku-123`\n- numeric range: `start:end` (e.g. `500:600`)\n- LIKE pattern: contains `%` or `_` (e.g. `ot%`, `%ot`, `%ot%`). Patterns are stored lowercased and matched case-insensitively.\n\nToken resolution order: pattern (`%`/`_`) → range (`:`) → exact. A token containing `%` is always treated as pattern, even if it also contains `:`.\n\nThis endpoint is \"replace all\": existing SKUs/ranges/patterns of the (collection, interface) pair are deleted before the new tokens are inserted.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "ot%; %ot; sku-exato-1; 500:600",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"success\": true\n}"
                                },
                                {
                                    "name": "Missing collection id or interface",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Use `text/plain` — the body is a raw semicolon-separated string, not JSON."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/collection/{{id}}/skus/by/{{interface}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "collection",
                                                "{{id}}",
                                                "skus",
                                                "by",
                                                "{{interface}}"
                                            ]
                                        },
                                        "description": "Replaces the SKU set of a collection for a given interface. The body is a plain semicolon-separated string (NOT JSON). Each token is one of:\n- exact SKU: `sku-123`\n- numeric range: `start:end` (e.g. `500:600`)\n- LIKE pattern: contains `%` or `_` (e.g. `ot%`, `%ot`, `%ot%`). Patterns are stored lowercased and matched case-insensitively.\n\nToken resolution order: pattern (`%`/`_`) → range (`:`) → exact. A token containing `%` is always treated as pattern, even if it also contains `:`.\n\nThis endpoint is \"replace all\": existing SKUs/ranges/patterns of the (collection, interface) pair are deleted before the new tokens are inserted.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "ot%; %ot; sku-exato-1; 500:600",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"error\": \"Bad Request\"\n}"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Ping",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "x-guper-authorization",
                        "value": "{{x-guper-authorization}}",
                        "type": "text",
                        "description": "User token issued by Guper."
                    },
                    {
                        "key": "Content-Type",
                        "value": "{{Content-Type}}",
                        "type": "text",
                        "description": "Always `application/json` for endpoints that accept a JSON body."
                    }
                ],
                "url": {
                    "raw": "https://{{organization}}.myguper.com/api/catalog/ping",
                    "protocol": "https",
                    "host": [
                        "{{organization}}",
                        "myguper",
                        "com"
                    ],
                    "path": [
                        "api",
                        "catalog",
                        "ping"
                    ]
                },
                "description": "Resource for checking service availability"
            },
            "response": [
                {
                    "name": "Success",
                    "originalRequest": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/catalog/ping",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "catalog",
                                "ping"
                            ]
                        },
                        "description": "Resource for checking service availability"
                    },
                    "status": "OK",
                    "code": 200,
                    "_postman_previewlanguage": "json",
                    "header": [
                        {
                            "key": "Content-Type",
                            "value": "application/json"
                        }
                    ],
                    "body": "{\n    \"account\": \"acme\",\n    \"response\": \"Server online\",\n    \"dateTime\": \"2023-08-11T13:48:50-03:00\"\n}"
                }
            ]
        },
        {
            "name": "Seller",
            "item": [
                {
                    "name": "By-entity",
                    "item": [
                        {
                            "name": "List refs of many Sellers",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/seller-external-ref/by-seller",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "seller-external-ref",
                                        "by-seller"
                                    ]
                                },
                                "description": "Same reverse lookup as `by-seller/{sellerId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the seller the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/seller-external-ref/by-seller",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "seller-external-ref",
                                                "by-seller"
                                            ]
                                        },
                                        "description": "Same reverse lookup as `by-seller/{sellerId}`, but for a page of entities at once:\nthe body is a JSON array of Guper ids (max 500).\n\nReturns a flat list `[{refId, source, id}]`, not grouped — `id` is the seller the\nrow belongs to. Built for the mapping grids in the panel, which paint entities x\ninterfaces and would otherwise need one call per row.\n\nIds with no mapping simply do not appear. An empty array in, an empty array out."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\",\"id\":42},{\"refId\":\"11-2\",\"source\":\"pos\",\"id\":42},{\"refId\":\"9-22\",\"source\":\"pos\",\"id\":51}]"
                                }
                            ]
                        },
                        {
                            "name": "List refs of a Seller",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/seller-external-ref/by-seller/{{sellerId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "seller-external-ref",
                                        "by-seller",
                                        "{{sellerId}}"
                                    ]
                                },
                                "description": "Lists every external `refId` mapped to one seller, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/seller/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the seller has no mapping. Does not 404 on an unknown id."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/seller-external-ref/by-seller/{{sellerId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "seller-external-ref",
                                                "by-seller",
                                                "{{sellerId}}"
                                            ]
                                        },
                                        "description": "Lists every external `refId` mapped to one seller, one row per `source` (interface).\n\nReverse of `/api/catalog/{interface}/seller/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the seller has no mapping. Does not 404 on an unknown id."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\"},{\"refId\":\"11-2\",\"source\":\"pos\"}]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "By-interface",
                    "item": [
                        {
                            "name": "Link Seller ref to existing entity",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Links this `refId` to an existing entity (passed by `sellerId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"sellerId\": 42\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Links this `refId` to an existing entity (passed by `sellerId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"sellerId\": 42\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_linked\":true}"
                                }
                            ]
                        },
                        {
                            "name": "List Seller refs",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller"
                                    ]
                                },
                                "description": "Lists every external ref for `seller` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller"
                                            ]
                                        },
                                        "description": "Lists every external ref for `seller` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}},{\"id\":89,\"name\":\"Adidas\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-ADIDAS-001\"}}]"
                                }
                            ]
                        },
                        {
                            "name": "Get Seller by ref",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Seller ref",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"success\":true}"
                                }
                            ]
                        },
                        {
                            "name": "Bulk resolve Seller refs",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/_resolve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller",
                                        "_resolve"
                                    ]
                                },
                                "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller/_resolve",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller",
                                                "_resolve"
                                            ]
                                        },
                                        "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"VTEX-NIKE-001\":42,\"VTEX-ADIDAS-001\":89,\"FAKE-DOES-NOT-EXIST\":null}"
                                }
                            ]
                        },
                        {
                            "name": "Create or get Seller ref",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "catalog",
                                        "{{interface}}",
                                        "seller"
                                    ]
                                },
                                "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/catalog/{{interface}}/seller",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "catalog",
                                                "{{interface}}",
                                                "seller"
                                            ]
                                        },
                                        "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_created\":true}"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ],
    "variable": [
        {
            "key": "scheme",
            "value": "https",
            "type": "string"
        },
        {
            "key": "organization",
            "value": "acme",
            "type": "string"
        },
        {
            "key": "TID",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "confirmToken",
            "value": "54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49",
            "type": "string"
        },
        {
            "key": "hash",
            "value": "h_demo_abc123def456",
            "type": "string"
        },
        {
            "key": "id",
            "value": "42",
            "type": "string"
        },
        {
            "key": "personId",
            "value": "1234",
            "type": "string"
        },
        {
            "key": "couponCode",
            "value": "DEMO20",
            "type": "string"
        },
        {
            "key": "transactionId",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "dateStart",
            "value": "2024-04-01",
            "type": "string"
        },
        {
            "key": "dateEnd",
            "value": "2024-04-30",
            "type": "string"
        },
        {
            "key": "x-guper-authorization",
            "value": "48c70a3d6bc1d15104abfaee80c6010f348713f5315bfd12028c2455667685a2",
            "type": "string"
        },
        {
            "key": "Content-Type",
            "value": "application/json",
            "type": "string"
        },
        {
            "key": "User-Agent",
            "value": "guper-docs/2.x",
            "type": "string"
        },
        {
            "key": "environment",
            "value": "",
            "type": "string"
        }
    ]
}