{ "info": { "name": "Verus NFS-e — API de integração v1", "description": "Defina a variável \"chave\" com a chave gerada em Integrações (API) no Verus. Documentação: https://verusnfe.megasystemsti.com.br/desenvolvedores", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{chave}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "https://verusnfe.megasystemsti.com.br" }, { "key": "chave", "value": "vrs_cole_sua_chave_aqui" } ], "item": [ { "name": "Conta", "item": [ { "name": "Dados da conta", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/conta", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "conta" ], "query": [] }, "description": "Conta da chave, plano e consumo da cota de notas. Bom para testar se a chave funciona." } } ] }, { "name": "Notas", "item": [ { "name": "Emitir nota", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas" ], "query": [] }, "description": "Valida, grava e responde 202 na hora com a nota \"na_fila\". A emissão na Sefin acontece em segundo plano; o resultado chega pelo webhook e pela consulta. Repetir a mesma \"referencia\" devolve a nota já existente (200, cabeçalho X-Verus-Ja-Recebida) e nunca emite outra. Se a nota daquela referência foi rejeitada, o novo envio corrige os dados e tenta de novo.", "body": { "mode": "raw", "raw": "{\n \"referencia\": \"pedido-98765\",\n \"prestador_cnpj\": \"11222333000181\",\n \"competencia\": \"2026-11-10\",\n \"servico_codigo\": \"010601\",\n \"valor\": 1500,\n \"discriminacao\": \"Consultoria em TI - novembro/2026\",\n \"tomador\": {\n \"cpf_cnpj\": \"11444777000161\",\n \"nome\": \"Cliente Exemplo Ltda\",\n \"email\": \"financeiro@clienteexemplo.com.br\",\n \"endereco\": {\n \"cep\": \"74000000\",\n \"logradouro\": \"Rua Exemplo\",\n \"numero\": \"100\",\n \"bairro\": \"Centro\",\n \"municipio\": \"Goiânia\",\n \"uf\": \"GO\",\n \"codigo_municipio_ibge\": \"5208707\"\n }\n }\n}" } } }, { "name": "Listar notas", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas" ], "query": [ { "key": "situacao", "value": "", "description": "na_fila, processando, autorizada, rejeitada, cancelamento_em_andamento, cancelada, importada", "disabled": true }, { "key": "prestador_id", "value": "", "description": "id do prestador", "disabled": true }, { "key": "competencia_de", "value": "", "description": "AAAA-MM-DD", "disabled": true }, { "key": "competencia_ate", "value": "", "description": "AAAA-MM-DD", "disabled": true }, { "key": "atualizadas_desde", "value": "", "description": "data/hora ISO 8601 — para sincronizar só o que mudou", "disabled": true }, { "key": "origem", "value": "", "description": "api ou sistema", "disabled": true }, { "key": "pagina", "value": "", "description": "número da página", "disabled": true }, { "key": "por_pagina", "value": "", "description": "1 a 100", "disabled": true } ] }, "description": "Notas da conta, mais recentes primeiro, 50 por página (máx. 100)." } }, { "name": "Consultar nota", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas/1", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas", "1" ], "query": [] }, "description": "Situação e dados de uma nota." } }, { "name": "Consultar pela referência", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas/referencia/pedido-98765", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas", "referencia", "pedido-98765" ], "query": [] }, "description": "A mesma consulta, usando a referência do seu sistema." } }, { "name": "Baixar PDF (DANFSe)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas/1/pdf", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas", "1", "pdf" ], "query": [] }, "description": "Arquivo PDF. Disponível para notas autorizadas, canceladas ou importadas (senão: 409 nota_sem_arquivo)." } }, { "name": "Baixar XML", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/notas/1/xml", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notas", "1", "xml" ], "query": [] }, "description": "XML oficial da NFS-e." } } ] }, { "name": "Cadastros", "item": [ { "name": "Listar prestadores", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/prestadores", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "prestadores" ], "query": [] }, "description": "Empresas prestadoras da conta, com o resumo do certificado." } }, { "name": "Consultar prestador", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/prestadores/1", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "prestadores", "1" ], "query": [] }, "description": "Um prestador." } }, { "name": "Certificados digitais", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/certificados", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "certificados" ], "query": [] }, "description": "Situação do certificado de cada prestador: valido, vencendo (30 dias), vencido ou ausente. Nunca devolve o arquivo nem a senha." } }, { "name": "Listar tomadores", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/tomadores", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "tomadores" ], "query": [ { "key": "cpf_cnpj", "value": "", "description": "filtra por documento", "disabled": true }, { "key": "prestador_id", "value": "", "description": "id do prestador", "disabled": true }, { "key": "busca", "value": "", "description": "parte do nome", "disabled": true }, { "key": "pagina", "value": "", "description": "número da página", "disabled": true }, { "key": "por_pagina", "value": "", "description": "1 a 100", "disabled": true } ] }, "description": "Clientes (tomadores) cadastrados, 50 por página." } }, { "name": "Consultar tomador", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/tomadores/1", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "tomadores", "1" ], "query": [] }, "description": "Um tomador." } }, { "name": "Listar serviços", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/servicos", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "servicos" ], "query": [ { "key": "prestador_id", "value": "", "description": "id do prestador", "disabled": true }, { "key": "codigo", "value": "", "description": "código do serviço", "disabled": true } ] }, "description": "Catálogo de serviços. O \"codigo\" (ou o código de tributação nacional) é o que se usa em servico_codigo na emissão." } }, { "name": "Consultar serviço", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/servicos/1", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "servicos", "1" ], "query": [] }, "description": "Um serviço." } } ] } ] }