{
  "info": {
    "_postman_id": "myse-nfe-v3-collection",
    "name": "Myse API — Nota Fiscal (v3)",
    "description": "Coleção oficial dos endpoints da Myse API de Nota Fiscal Eletrônica. Configure as variáveis `base` e `token` no Environment antes de usar.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "Authorization", "type": "string" },
      { "key": "value", "value": "Token {{token}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "variable": [
    { "key": "base", "value": "https://api.mysebr.com.br/nfemyse-v3/rest", "type": "string" },
    { "key": "token", "value": "SEU_TOKEN_AQUI", "type": "string" },
    { "key": "recibo", "value": "", "type": "string" },
    { "key": "chave_nfe", "value": "", "type": "string" }
  ],
  "item": [
    {
      "name": "Status",
      "item": [
        {
          "name": "GET /health",
          "request": {
            "method": "GET",
            "auth": { "type": "noauth" },
            "url": { "raw": "{{base}}/health", "host": ["{{base}}"], "path": ["health"] }
          }
        }
      ]
    },
    {
      "name": "NFe",
      "item": [
        {
          "name": "GET /nfe (listar com paginação)",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfe?page=1&page_size=20",
              "host": ["{{base}}"],
              "path": ["nfe"],
              "query": [
                { "key": "page", "value": "1" },
                { "key": "page_size", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "GET /nfe/nota/:recibo",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfe/nota/{{recibo}}",
              "host": ["{{base}}"],
              "path": ["nfe", "nota", "{{recibo}}"]
            }
          }
        },
        {
          "name": "GET /nfe/nota/:recibo/completa",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfe/nota/{{recibo}}/completa",
              "host": ["{{base}}"],
              "path": ["nfe", "nota", "{{recibo}}", "completa"]
            }
          }
        },
        {
          "name": "POST /nfe/emissao",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"serie\": \"1\",\n  \"cfop\": \"5102\",\n  \"numero-origem\": \"PED-2026-00042\",\n  \"tipo\": \"S\",\n  \"finalidade\": \"N\",\n  \"valor-despesas\": \"0.00\",\n  \"cliente\": \"12345678000199\",\n  \"transporte\": { \"modalidade\": \"9\" },\n  \"itens\": [\n    { \"produto\": \"SKU-001\", \"quantidade\": \"2\", \"valor-unitario\": \"89.90\" }\n  ]\n}"
            },
            "url": { "raw": "{{base}}/nfe/emissao", "host": ["{{base}}"], "path": ["nfe", "emissao"] }
          }
        },
        {
          "name": "PUT /nfe/:id (alterar)",
          "request": {
            "method": "PUT",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{ \"serie\": \"1\", \"cfop\": \"5102\", \"itens\": [] }" },
            "url": { "raw": "{{base}}/nfe/123", "host": ["{{base}}"], "path": ["nfe", "123"] }
          }
        },
        {
          "name": "POST /nfe/correcao (carta de correção)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chave\": \"{{chave_nfe}}\",\n  \"motivo\": \"Correção da descrição do item 3 — modelo correto: XYZ-2.\"\n}"
            },
            "url": { "raw": "{{base}}/nfe/correcao", "host": ["{{base}}"], "path": ["nfe", "correcao"] }
          }
        },
        {
          "name": "POST /nfe/cancelamento",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chave\": \"{{chave_nfe}}\",\n  \"motivo\": \"Cancelamento solicitado pelo cliente — pedido refeito.\"\n}"
            },
            "url": { "raw": "{{base}}/nfe/cancelamento", "host": ["{{base}}"], "path": ["nfe", "cancelamento"] }
          }
        }
      ]
    },
    {
      "name": "NFCe",
      "item": [
        {
          "name": "GET /nfce (listar com paginação)",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfce?page=1&page_size=20",
              "host": ["{{base}}"],
              "path": ["nfce"],
              "query": [
                { "key": "page", "value": "1" },
                { "key": "page_size", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "GET /nfce/cupom/:recibo",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfce/cupom/{{recibo}}",
              "host": ["{{base}}"],
              "path": ["nfce", "cupom", "{{recibo}}"]
            }
          }
        },
        {
          "name": "POST /nfce/emissao",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"serie\": \"65\",\n  \"cfop\": \"5102\",\n  \"numero-origem\": \"VENDA-2026-00100\",\n  \"tp_pagamento\": \"dinheiro\",\n  \"itens\": [\n    { \"produto\": \"SKU-001\", \"quantidade\": \"1\", \"valor-unitario\": \"59.90\" }\n  ]\n}"
            },
            "url": { "raw": "{{base}}/nfce/emissao", "host": ["{{base}}"], "path": ["nfce", "emissao"] }
          }
        },
        {
          "name": "POST /nfce/cancelamento",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chave\": \"{{chave_nfe}}\",\n  \"motivo\": \"Cancelamento solicitado pelo cliente.\"\n}"
            },
            "url": { "raw": "{{base}}/nfce/cancelamento", "host": ["{{base}}"], "path": ["nfce", "cancelamento"] }
          }
        }
      ]
    },
    {
      "name": "NFSe",
      "item": [
        {
          "name": "GET /nfse (com dataInicial)",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/nfse?dataInicial=2026-05-01&page=1&page_size=20",
              "host": ["{{base}}"],
              "path": ["nfse"],
              "query": [
                { "key": "dataInicial", "value": "2026-05-01" },
                { "key": "page", "value": "1" },
                { "key": "page_size", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "POST /nfse/emissao",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numero-origem\": \"OS-2026-00088\",\n  \"observacao\": \"Serviço de consultoria.\",\n  \"cliente\": \"12345678000199\",\n  \"itens\": [\n    { \"produto\": \"SRV-CONSULT\", \"quantidade\": \"10\", \"valor-unitario\": \"250.00\" }\n  ]\n}"
            },
            "url": { "raw": "{{base}}/nfse/emissao", "host": ["{{base}}"], "path": ["nfse", "emissao"] }
          }
        },
        {
          "name": "POST /nfse/cancelamento",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chave\": \"chave_nfse_aqui\",\n  \"motivo\": \"Cancelamento solicitado pelo tomador.\"\n}"
            },
            "url": { "raw": "{{base}}/nfse/cancelamento", "host": ["{{base}}"], "path": ["nfse", "cancelamento"] }
          }
        }
      ]
    },
    {
      "name": "Fornecedor",
      "item": [
        {
          "name": "GET /nffornecedor",
          "request": {
            "method": "GET",
            "url": { "raw": "{{base}}/nffornecedor", "host": ["{{base}}"], "path": ["nffornecedor"] }
          }
        },
        {
          "name": "POST /nffornecedor/reconhecimento",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chave\": \"{{chave_nfe}}\",\n  \"codigo-reconhecimento\": \"210200\"\n}"
            },
            "url": { "raw": "{{base}}/nffornecedor/reconhecimento", "host": ["{{base}}"], "path": ["nffornecedor", "reconhecimento"] }
          }
        }
      ]
    },
    {
      "name": "Clientes",
      "item": [
        {
          "name": "GET /clientes",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/clientes?page=1&page_size=100",
              "host": ["{{base}}"],
              "path": ["clientes"],
              "query": [
                { "key": "page", "value": "1" },
                { "key": "page_size", "value": "100" }
              ]
            }
          }
        },
        {
          "name": "GET /clientes/:doc",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/clientes/12345678000199",
              "host": ["{{base}}"],
              "path": ["clientes", "12345678000199"]
            }
          }
        },
        {
          "name": "POST /clientes",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tipo\": \"J\",\n  \"razao-social\": \"Empresa Exemplo Ltda\",\n  \"cnpj\": \"12345678000199\",\n  \"tipo-inscricao-estadual\": \"1\",\n  \"inscricao-estadual\": \"ISENTO\",\n  \"endereco\": {\n    \"cep\": \"01310100\",\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1000\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\"\n  }\n}"
            },
            "url": { "raw": "{{base}}/clientes", "host": ["{{base}}"], "path": ["clientes"] }
          }
        },
        {
          "name": "PUT /clientes/:doc",
          "request": {
            "method": "PUT",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{ \"tipo\": \"J\", \"razao-social\": \"Novo Nome\" }" },
            "url": { "raw": "{{base}}/clientes/12345678000199", "host": ["{{base}}"], "path": ["clientes", "12345678000199"] }
          }
        },
        {
          "name": "DELETE /clientes/:doc",
          "request": {
            "method": "DELETE",
            "url": { "raw": "{{base}}/clientes/12345678000199", "host": ["{{base}}"], "path": ["clientes", "12345678000199"] }
          }
        }
      ]
    },
    {
      "name": "Produtos",
      "item": [
        {
          "name": "GET /produtos",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{base}}/produtos?page=1&page_size=100",
              "host": ["{{base}}"],
              "path": ["produtos"]
            }
          }
        },
        {
          "name": "POST /produtos",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"referencia\": \"SKU-001\",\n  \"nome\": \"Camiseta Polo\",\n  \"valor\": \"89.90\",\n  \"medida\": \"UN\",\n  \"ncm\": \"61051000\",\n  \"origem\": \"0\",\n  \"cfop-preferencial\": \"5102\",\n  \"tipo-produto\": \"P\"\n}"
            },
            "url": { "raw": "{{base}}/produtos", "host": ["{{base}}"], "path": ["produtos"] }
          }
        }
      ]
    }
  ]
}