# Integrações

# Integração via webhook

Na integração via webhook, o sistema V2Saúde realiza o envio de notificações para um endereço especificado, utilizando uma estrutura de dados específica de acordo com o tipo de notificação.

#### Ativação de webhooks

Os webhooks podem ser ativados na página Cadastros > Empresa e preferências, na aba "Integrações".  
É necessária a contratação do mõdulo de webhooks para utilizar esta função.

[![image-1737333886755.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737333886755.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737333886755.png)

Ao clicar em "Gerenciar webhooks", a página de gerenciamento de webhooks será exibida. Nesta página é possível gerir as notificações configuradas para a empresa:

[![image-1737333968778.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737333968778.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737333968778.png)

Clique em "Novo webhook" para cadastrar um novo webhook:

[![image-1737334004801.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737334004801.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737334004801.png)

Escolha o tipo, a API Key e a URL do webhook.

#### Linhas gerais sobre o envio de webhooks  


As seguintes informações se aplicam a todas as chamadas de webhook:

1. O V2Saúde realiza chamadas POST para a URL especificada
2. A API Key informada será enviada no cabeçalho (header) "Authorization" da requisição

#### Tipos de webhook  


Os seguintes tipos de webhook são atualmente suportados.

##### Cadastro e alterações em cirurgias

Uma notificação é enviada sempre que uma cirurgia for inserida ou modificada no sistema.

Exemplo de payload da requisição:

`[<br></br>    {<br></br>        "id": 583581,<br></br>        "cliente": {<br></br>            "id": 63387,<br></br>            "nome": "BRADESCO SAUDE - OPERADORA DE PLANOS S/A",<br></br>            "razaoSocial": "BRADESCO SAUDE - OPERADORA DE PLANOS S/A",<br></br>            "cnpj": "15.011.651/0001-54",<br></br>            "cpf": null<br></br>        },<br></br>        "responsavel": "MACHADO DE ASSIS",<br></br>        "paciente": "JOSE DE ALENCAR",<br></br>        "matriculaPaciente": "",<br></br>        "medico": "GRACILIANO RAMOS",<br></br>        "medicoCRM": "1234",<br></br>        "procedimento": "CIRURGIA DE QUADRIL",<br></br>        "data": "2025-01-01",<br></br>        "dataDeCadastro": "2025-01-01",<br></br>        "finalizada": false,<br></br>        "dataDeFinalizacao": null,<br></br>        "dataOrcamentoPos": null,<br></br>        "dataLiberacaoMaterial": null,<br></br>        "dataLimiteRetirada": null,<br></br>        "finalizadaPor": null,<br></br>        "observacao": "",<br></br>        "observacaoVale": "",<br></br>        "observacaoPos": null,<br></br>        "horaCirurgia": "14:30",<br></br>        "cancelada": false,<br></br>        "vendedor": {<br></br>            "id": null,<br></br>            "nome": null,<br></br>            "razaoSocial": null,<br></br>            "cnpj": null,<br></br>            "cpf": null<br></br>        },<br></br>        "hospital": {<br></br>            "id": 62707,<br></br>            "nome": "ALBERT EINSTEIN",<br></br>            "razaoSocial": "",<br></br>            "cnpj": "",<br></br>            "cpf": null<br></br>        },<br></br>        "convenio": {<br></br>            "id": 63387,<br></br>            "nome": "BRADESCO SAUDE - OPERADORA DE PLANOS S/A",<br></br>            "razaoSocial": "BRADESCO SAUDE - OPERADORA DE PLANOS S/A",<br></br>            "cnpj": "15.011.651/0001-54",<br></br>            "cpf": null<br></br>        },<br></br>        "codigoSus": "",<br></br>        "cirurgiaBaixada": false,<br></br>        "observacaoBaixa": null,<br></br>        "nota": null,<br></br>        "statusCotacao": "APROVADA",<br></br>        "procedimentoCirurgico": null,<br></br>        "numeroEmpenho": ""<br></br>    }<br></br>]`

Os seguintes atributos fazem parte do payload da requisição

<table border="1" id="bkmrk-atributo-registro-pa" style="border-collapse: collapse; width: 100%; height: 715.2px;"><tbody><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">**Atributo**  
</td><td style="width: 18.9122%; height: 29.8px;">**Registro Pai**  
</td><td style="width: 31.026%; height: 29.8px;">**Tipo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Descrição**  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">id  
</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Número  
</td><td style="width: 24.9691%; height: 29.8px;">Código da cirurgia  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cliente  
</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Pessoa (ver Registros Auxiliares)  
</td><td style="width: 24.9691%; height: 29.8px;">Dados do cliente  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">responsavel</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String</td><td style="width: 24.9691%; height: 29.8px;">Responsável pela cirurgia</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">paciente</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String</td><td style="width: 24.9691%; height: 29.8px;">Nome do paciente</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">matriculaPaciente</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String</td><td style="width: 24.9691%; height: 29.8px;">Matrícula do paciente</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">medico</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String</td><td style="width: 24.9691%; height: 29.8px;">Nome do médico</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">medicoCRM</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">CRM do médico  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">procedimento</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Descrição do procedimento  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">data</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Date  
</td><td style="width: 24.9691%; height: 29.8px;">Data da cirurgia  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">dataDeCadastro</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">DateTime  
</td><td style="width: 24.9691%; height: 29.8px;">Data de cadastro  
</td></tr><tr><td style="width: 24.9691%; height: 29.8px;">cadastradoPor</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Pessoa (ver Registros Auxiliares)</td><td style="width: 24.9691%; height: 29.8px;">Usuário responsável pelo cadastro  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">finalizada</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Boolean  
</td><td style="width: 24.9691%; height: 29.8px;">Cirurgia finalizada?  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">dataDeFinalizacao</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">DateTime  
</td><td style="width: 24.9691%; height: 29.8px;">Data da finalização  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">dataOrcamentoPos</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">DateTIme  
</td><td style="width: 24.9691%; height: 29.8px;">Data do orçamento pś  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">dataLiberacaoMaterial</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">DateTime  
</td><td style="width: 24.9691%; height: 29.8px;">Data da liberação do material  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">dataLimiteRetirada</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">DateTime  
</td><td style="width: 24.9691%; height: 29.8px;">Data limite da retirada do material consignado  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">finalizadaPor</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Pessoa (ver Registros Auxiliares)</td><td style="width: 24.9691%; height: 29.8px;">Usuário responsável pela finalização  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">observacao</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Observações da cirurgia  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">observacaoVale</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Observações do vale/consignação  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">observacaoPos</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Observações do orçamento pós  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">horaCirurgia</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Time  
</td><td style="width: 24.9691%; height: 29.8px;">Hora da cirurgia  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cancelada</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Boolean  
</td><td style="width: 24.9691%; height: 29.8px;">Cirurgia cancelada?  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">vendedor</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Pessoa (ver Registros Auxiliares)</td><td style="width: 24.9691%; height: 29.8px;">Vendedor  
</td></tr><tr><td style="width: 24.9691%;">hospital</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">Pessoa (ver Registros Auxiliares)</td><td style="width: 24.9691%;">Hospital  
</td></tr><tr><td style="width: 24.9691%;">convenio</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">Pessoa (ver Registros Auxiliares)</td><td style="width: 24.9691%;">Convênio  
</td></tr><tr><td style="width: 24.9691%;">codigoSus</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">String  
</td><td style="width: 24.9691%;">Código SUS do procedimento  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cirurgiaBaixada</td><td style="width: 18.9122%; height: 29.8px;">  
</td><td style="width: 31.026%; height: 29.8px;">Boolean  
</td><td style="width: 24.9691%; height: 29.8px;">Cirurgia com pagamento cancelado/baixado?  
</td></tr><tr><td style="width: 24.9691%;">observacaoBaixa</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">String  
</td><td style="width: 24.9691%;">Observações da baixa  
</td></tr><tr><td style="width: 24.9691%;">nota</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">Número  
</td><td style="width: 24.9691%;">Número da nota fiscal de venda  
</td></tr><tr><td style="width: 24.9691%;">statusCotacao</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">String  
</td><td style="width: 24.9691%;">Status da cotação.  
Os seguintes valores são suportados:  
  
- APROVADA  
    Cotação aprovada
- NAO\_APROVADA  
    Cotação não aprovada
- EM\_ANDAMENTO  
    Aprovação em andamento
- PERDIDA  
    Cotação perdida

</td></tr><tr><td style="width: 24.9691%;">procedimentoCirurgico</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">String  
</td><td style="width: 24.9691%;">Descrição do procedimento  
</td></tr><tr><td style="width: 24.9691%;">numeroEmpenho</td><td style="width: 18.9122%;">  
</td><td style="width: 31.026%;">String  
</td><td style="width: 24.9691%;">Número do empenho da licitação  
</td></tr></tbody></table>

##### Cadastro e alterações em orçamentos pré  


Uma notificação é enviada quando o orçamento pré de uma cirurgia é alterado.

Exemplo de payload da requisição:

`[<br></br>    {<br></br>        "id": 48391,<br></br>        "cirurgia": {<br></br>            "id": 142913,<br></br>            "cliente": {<br></br>                "id": 1234,<br></br>                "nome": "AMIL",<br></br>                "razaoSocial": null,<br></br>                "cnpj": "11.111.111/0001-11",<br></br>                "cpf": null<br></br>            },<br></br>            "responsavel": "AUGUSTO DOS ANJOS",<br></br>            "paciente": "CARLOS DRUMMOND DE ANDRADE",<br></br>            "matriculaPaciente": null,<br></br>            "medico": "VINICIUS DE MORAIS",<br></br>            "medicoCRM": "9196",<br></br>            "instrumentadoresAvulsos": null,<br></br>            "procedimento": "RESSECÇAO ENDOSCOPICA DA PROSTATA",<br></br>            "data": "2025-01-01",<br></br>            "dataDeCadastro": "2025-01-01",<br></br>            "finalizada": false,<br></br>            "dataDeFinalizacao": null,<br></br>            "dataOrcamentoPos": null,<br></br>            "dataLiberacaoMaterial": null,<br></br>            "dataLimiteRetirada": null,<br></br>            "finalizadaPor": null,<br></br>            "observacao": "",<br></br>            "observacaoVale": null,<br></br>            "observacaoPos": null,<br></br>            "horaCirurgia": "16:00",<br></br>            "cancelada": false,<br></br>            "vendedor": {<br></br>                "id": 1829,<br></br>                "nome": "NOME DO VENDEDOR",<br></br>                "razaoSocial": null,<br></br>                "cnpj": null,<br></br>                "cpf": null<br></br>            },<br></br>            "hospital": {<br></br>                "id": null,<br></br>                "nome": null,<br></br>                "razaoSocial": null,<br></br>                "cnpj": null,<br></br>                "cpf": null<br></br>            },<br></br>            "convenio": {<br></br>                "id": null,<br></br>                "nome": null,<br></br>                "razaoSocial": null,<br></br>                "cnpj": null,<br></br>                "cpf": null<br></br>            },<br></br>            "codigoSus": null,<br></br>            "cirurgiaBaixada": false,<br></br>            "observacaoBaixa": null,<br></br>            "nota": null,<br></br>            "statusCotacao": "APROVADA",<br></br>            "procedimentoCirurgico": null,<br></br>            "numeroEmpenho": null,<br></br>            "action": null<br></br>        },<br></br>        "cadastradoPor": {<br></br>            "id": 1747,<br></br>            "nome": "OPERADOR DO SISTEMA",<br></br>            "razaoSocial": null,<br></br>            "cnpj": null,<br></br>            "cpf": null<br></br>        },<br></br>        "aprovado": false,<br></br>        "data": "2025-01-01",<br></br>        "dataAprovacao": null,<br></br>        "observacoes": "",<br></br>        "desconto": 0,<br></br>        "itens": [<br></br>            {<br></br>                "id": 170011,<br></br>                "produto": {<br></br>                    "id": 235167,<br></br>                    "descricao": "CARGA  ARTICULADA ROXA P3H 45 MM",<br></br>                    "referenciaFabricante": "CADD45ENTS",<br></br>                    "registroAnvisa": "80940400003",<br></br>                    "codigoDeBarras": "1000001048024",<br></br>                    "fabricante": {<br></br>                        "id": 101565,<br></br>                        "nome": "PANTHER HEALTHCARE",<br></br>                        "razaoSocial": null,<br></br>                        "cnpj": null,<br></br>                        "cpf": null<br></br>                    }<br></br>                },<br></br>                "valor": 500,<br></br>                "desconto": 0,<br></br>                "quantidade": 1,<br></br>                "quantidadeAutorizada": 0,<br></br>                "quantidadeDoacao": 0<br></br>            }<br></br>        ]<br></br>    }<br></br>]`

Os seguintes atributos fazem parte do payload da requisição:

<table border="1" id="bkmrk-atributo-registro-pa-0" style="border-collapse: collapse; width: 100%; height: 298px;"><tbody><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">**Atributo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Registro Pai**  
</td><td style="width: 24.9691%; height: 29.8px;">**Tipo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Descrição**  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">id  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Número  
</td><td style="width: 24.9691%; height: 29.8px;">Código do orçamento  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cirurgia  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Cirurgia (ver Cadastro e alterações em cirurgias)  
</td><td style="width: 24.9691%; height: 29.8px;">Dados da cirurgia  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cadastradoPor  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Pessoa  
</td><td style="width: 24.9691%; height: 29.8px;">Usuário responsável pelo cadastro do orçamento  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">aprovado  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Boolean  
</td><td style="width: 24.9691%; height: 29.8px;">Aprovado?  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">data  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Date  
</td><td style="width: 24.9691%; height: 29.8px;">Data do orçamento  
</td></tr><tr><td style="width: 24.9691%;">dataAprovacao</td><td style="width: 24.9691%;">  
</td><td style="width: 24.9691%;">Date  
</td><td style="width: 24.9691%;">Data de aprovação do orçamento  
</td></tr><tr><td style="width: 24.9691%;">observacoes</td><td style="width: 24.9691%;">  
</td><td style="width: 24.9691%;">String  
</td><td style="width: 24.9691%;">Observações do orçamento  
</td></tr><tr><td style="width: 24.9691%;">desconto</td><td style="width: 24.9691%;">  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Valor do desconto  
</td></tr><tr><td style="width: 24.9691%;">itens</td><td style="width: 24.9691%;">  
</td><td style="width: 24.9691%;">Objeto  
</td><td style="width: 24.9691%;">Itens do orçamento  
</td></tr><tr><td style="width: 24.9691%;">id  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Código do orçamento  
</td></tr><tr><td style="width: 24.9691%;">produto  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Produto  
</td><td style="width: 24.9691%;">Dados do produto  
</td></tr><tr><td style="width: 24.9691%;">valor  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Valor unitário  
</td></tr><tr><td style="width: 24.9691%;">desconto  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Desconto  
</td><td style="width: 24.9691%;">Valor do desconto  
</td></tr><tr><td style="width: 24.9691%;">quantidade  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Quantidade  
</td></tr><tr><td style="width: 24.9691%;">quantidadeAutorizada  
</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Quantidade autorizada  
</td></tr><tr><td style="width: 24.9691%;">quantidadeDoacao</td><td style="width: 24.9691%;">itens  
</td><td style="width: 24.9691%;">Número  
</td><td style="width: 24.9691%;">Quantidade que não deve ser faturada (doada)  
</td></tr></tbody></table>

#### Registros auxiliares  


##### Pessoa

<table border="1" id="bkmrk-atributo-registro-pa-1" style="border-collapse: collapse; width: 100%; height: 298px;"><tbody><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">**Atributo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Registro Pai**  
</td><td style="width: 24.9691%; height: 29.8px;">**Tipo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Descrição**  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">id  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Número  
</td><td style="width: 24.9691%; height: 29.8px;">Código  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">nome  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Nome  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">razaoSocial  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Razão social  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cnpj  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">CNPJ  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">cpf  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">CPF  
</td></tr></tbody></table>

##### Produto

<table border="1" id="bkmrk-atributo-registro-pa-2" style="border-collapse: collapse; width: 100%; height: 298px;"><tbody><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">**Atributo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Registro Pai**  
</td><td style="width: 24.9691%; height: 29.8px;">**Tipo**  
</td><td style="width: 24.9691%; height: 29.8px;">**Descrição**  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">id  
</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">Número  
</td><td style="width: 24.9691%; height: 29.8px;">Código  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">descricao</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Descrição  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">referenciaFabricante</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Referência do fabricante  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">registroAnvisa</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Número do registro na Anvisa  
</td></tr><tr style="height: 29.8px;"><td style="width: 24.9691%; height: 29.8px;">codigoDeBarras</td><td style="width: 24.9691%; height: 29.8px;">  
</td><td style="width: 24.9691%; height: 29.8px;">String  
</td><td style="width: 24.9691%; height: 29.8px;">Código de barras  
</td></tr><tr><td style="width: 24.9691%;">fabricante  
</td><td style="width: 24.9691%;">  
</td><td style="width: 24.9691%;">Pessoa  
</td><td style="width: 24.9691%;">Dados do fabricante  
</td></tr></tbody></table># Agendor

<span data-contrast="auto">A integração do V2Saúde com o Agendor, realiza a integração dos deals ganhos do Agendor como cirurgias aprovadas no estágio de orçamento pré.</span><span data-ccp-props="{}"> </span>

<span data-contrast="auto">Durante a integração do deal do Agendor com a cirurgia no V2Saúde, o sistema irá criar a cirurgia com os dados do Agendor, registrar os itens do orçamento e, se necessário, cadastrar o cliente caso não seja encontrado no sistema.</span><span data-ccp-props="{}"> </span>

#### **<span data-contrast="none">Pré requisitos  
</span>**

<span data-contrast="none">Para realizar a integração com o Agendor, é preciso:  
</span>

- <span data-contrast="none"><span data-contrast="none">Um token de integração no Agendor  
    O token de integração deve ser obtido na interface do Agendor:  
      
    </span></span>[![image-1737337263866.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337263866.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337263866.png)
    
    [![image-1737337352310.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337352310.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337352310.png)
- <span data-contrast="none">Uma assinatura paga do Agendor, para poder utilizar os campos customizados</span>
- <span data-contrast="none">A contratação do módulo no sistema V2Saúde</span>

#### **<span data-contrast="none">Configurações  
</span>**

Após a geração do token no Agendor e contratação do mõdulo no sistema, basta configurar a integração.  
As configurações da integração são definidas no cadastro da empresa, aba Integrações.

[![image-1737337326911.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337326911.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337326911.png)

#### **<span data-contrast="none">Fluxo de integração  
</span>**

<span data-contrast="auto">Para a integração de orçamentos, é importante mencionar que os produtos informados no Agendor precisam ter exatamente a mesma referência que o V2Saúde. A integração não cadastra novos produtos no V2.</span><span data-ccp-props="{}"> </span>

- <span data-contrast="auto">A API do Agendor é executada no endpoint: /deals/stream?dealStatus=2&amp;since=\[DATA\]T00:00:00Z&amp;withCustomFields=true</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Este endpoint retorna os negócios ganhos recentemente desde a data especificada.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Por padrão, a aplicação irá fornecer a data do dia anterior para filtrar os negócios</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Para cada negócio retornado pela, API, a aplicação irá executar as seguintes ações:</span>   
    <span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

1. <span data-contrast="auto">Verifica se o deal do Agendor já foi cadastrado como cirurgia através de seu código legado. O código legado é composto pelo prefixo “agendor-” e o id do negócio no Agendor. Se uma cirurgia com o código legado já existir, ela não é integrada novamente e o processo segue para o próximo negócio da lista.</span>
2. Integração do cliente  
    <span data-contrast="auto">O negócio do Agendor pode ter uma Organization ou uma Person, para pessoas jurídicas e físicas respectivamente.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">Se o cliente não for encontrado, ele é cadastrado no V2.  
      
    </span>
3. <span data-contrast="auto">Integração dos produtos</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">Para cada produto informado no deal, a aplicação verifica se o produto existe no V2 com a referência do fabricante informada no campo “code” do produto no Agendor.  
    </span><span data-contrast="auto">Se o produto não for encontrado, uma observação é gravada no orçamento informando que o produto não foi localizado</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">. </span><span data-contrast="auto">Importante: Não são cadastrados produtos no V2</span>
4. <span data-contrast="auto">Integração da cirurgia</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">O negócio do Agendor é integrado no V2 como cirurgia.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">Alguns campos customizados do Agendor são utilizados no V2 para preencher as informações da cirurgia.  
    Os seguintes campos são integrados:  
    </span>

1. <span data-contrast="auto">Cliente</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>
2. <span data-contrast="auto">Hospital</span>   
    <span data-contrast="auto">Campo customizado hospital</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
3. <span data-contrast="auto">Convênio</span>   
    <span data-contrast="auto">Campo customizado convenio</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
4. <span data-contrast="auto">Paciente</span>   
    <span data-contrast="auto">Campo customizado paciente</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
5. <span data-contrast="auto">Data da cirurgia</span>   
    <span data-contrast="auto">Campo wonAt do negócio</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
6. <span data-contrast="auto">Médico</span>   
    <span data-contrast="auto">Campo customizado medico</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
7. <span data-contrast="auto">Observação</span>   
    <span data-contrast="auto">Observações da integração do deal.</span>   
    <span data-contrast="auto">Este campo é formado pelo campo description do negócio e pelo sufixo “Criada a partir do Agendor: \[url do deal no agendor\]”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
8. <span data-contrast="auto">Data de cadastro</span>   
    <span data-contrast="auto">Data atual</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
9. <span data-contrast="auto">Código legado</span>   
    <span data-contrast="auto">Formado pelo prefixo “agendor-” + id do negócio no Agendor</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
10. <span data-contrast="auto">Observações do agendamento</span>   
    <span data-contrast="auto">Campo personalizado “grade\_da\_cirurgia”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
11. <span data-contrast="auto">Procedimento</span>   
    <span data-contrast="auto">Campo personalizado “procedimento\_cirurgico”</span>   
    <span data-contrast="auto">Caso o procedimento não exista no V2, é automaticamente criado.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span>
12. <span data-contrast="auto">Vendedor</span>   
    <span data-contrast="auto">Campo personalizado “vendedor”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

#### **<span data-contrast="none">Integração dos clientes</span>**<span data-ccp-props="{"134233117":false,"134233118":false,"134245418":true,"134245529":true,"335559738":281,"335559739":281}"> </span>

<span data-contrast="auto">Durante o processo de integração das cirurgias, a aplicação irá verificar se o cliente existe pelo CNPJ ou CPF.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

<span data-contrast="auto">Caso o cliente não exista, ele é cadastrado no V2 utilizando os campos do Agendor.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

<span data-contrast="auto">No Agendor, o cadastro do cliente deve conter os campos obrigatórios no V2 para que o cadastrado possa ser completado. Do contrário a cirurgia não será integrada.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

***<span data-contrast="none">Campos obrigatórios no cadastro do cliente:</span>***<span data-ccp-props="{"134233117":false,"134233118":false,"134245418":true,"134245529":true,"335559738":319,"335559739":319}"> </span>

- <span data-contrast="auto">Nome</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Razão Social (Para clientes PJ)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">CPF (Para clientes PF)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">CNPJ (Para clientes PJ)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Inscrição Estadual (Para clientes PJ)</span>   
    <span data-contrast="auto">Neste caso, o campo customizado de inscrição estadual é utilizado. Caso não seja informado no Agendor, o sistema irá preencher automaticamente “ISENTO”.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">E-mail</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Telefone</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Endereço completo</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Cidade / Estado</span>   
    <span data-contrast="auto">A cidade e estado no Agendor são campos texto. A cidade precisa ser informada exatamente como registrada no V2. Não serão aceitas cidades abreviadas, ex: S. Paulo, ou estados com UF inválida.</span>   
    <span data-contrast="auto">Caso a cidade não exista no V2, haverá erro de integração da cirurgia.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span># Integração com Neogrid

####   


#### Sincronia entre Consumo e Reposição

A integração entre o <span style="color: #236fa1;">**V2Saúde**</span> e a <span style="color: #ba372a;">**Neogrid**</span> automatiza a visibilidade do seu estoque e do consumo de materiais para o fabricante. O processo ocorre de forma transparente: a Neogrid solicita os dados ao sistema com base em períodos específicos, e o V2Saúde responde automaticamente com informações atualizadas.

Com essa tecnologia, o fornecedor monitora estoques locais e em consignação, analisando a necessidade de reposição baseada na sua <span style="text-decoration: underline;">demanda real</span>. Isso transforma as movimentações internas em inteligência logística, garantindo que o insumo certo esteja disponível no momento exato.

### Como funciona na prática?

- **Automação Inteligente:** O <span style="color: #236fa1;">V2Saúde</span> processa e responde automaticamente às consultas da <span style="color: #ba372a;">Neogrid</span>, eliminando processos manuais o que acarreta na eliminação de erros operacionais.
- **Visibilidade:** O fornecedor passa a visualizar o fluxo de consumo e a posição detalhada dos estoques (atual, consignado e pendente de faturamento).
- **Eficiência Logística:** A reposição passa a ser baseada na sua <span style="text-decoration: underline;">demanda real</span>, otimizando o giro de estoque e prevenindo tanto a falta quanto o excesso de insumos.

### O que a integração faz?

- **Consulta de Vendas:** Reporta as notas fiscais emitidas no período solicitado trazendo visibilidade de consumo.
- **Consulta de Estoque:** Informa o saldo dos produtos presentes no estoque atual, consignado e pendências de faturamento.

### Configurando a integração no V2 saúde

- A integração deve ser configurada em **Cadastros &gt; Empresa e preferências**;

[![image-1772560515787.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772560515787.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772560515787.png)

- Acesse a aba **"Integrações"** e selecione **SIM** para <span style="text-decoration: underline;">'Integração com Neogrid?';</span>

 [![image-1772549266280.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772549266280.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772549266280.png)

- Após esta etapa basta acessar o cadastro do <span style="text-decoration: underline;">**Fabricante**</span> em **Estoque &gt; Fabricante**;

[![image-1772562527401.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772562527401.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772562527401.png)

- Clique em 'Editar';

[![image-1772562695466.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772562695466.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772562695466.png)

- No cadastro do fabricante clique em 'Gerar novo token' para gerar o token de identificação que será utilizado nas consultas da Neogrid.

[![image-1772563063396.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772563063396.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772563063396.png)

- Sinalize a caixa 'Ativar Sell Out nas notas emitidas com produtos deste fabricante?' e posteriormente em '**Salvar**'.

[![image-1772563983972.png](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1772563983972.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2026-03/image-1772563983972.png)

### Documentação Técnica: API de Consumo de Dados Neogrid

**1. Relatório de vendas (verificação de consumo)**

- <span style="text-decoration: underline;">Requisição:</span>

1. 1. POST: \[URL BASE\]/v2-api/sellout/neogrid/notas
    2. Authorization: Neogrid\[Token de integração do Fabricante\]
    3. Validação: Período não pode exceder 90 dias

```
{<br></br>    "dataInicial": "2025-04-02",<br></br>    "dataFinal": "2025-04-02"<br></br>}
```

- <span style="text-decoration: underline;">Retorno de requisição:</span>

```
{<br></br>    "relatorioVendas": {<br></br>        "tipoRegistro": "01",<br></br>        "identificacao": "VENDAS",<br></br>        "versao": "052",<br></br>        "numeroRelatorio": "01",<br></br>        "dataEmissao": "2026-03-05T10:46:35.9",<br></br>        "dataInicialPeriodoVenda": "2025-04-02",<br></br>        "dataFinalPeriodoVenda": "2025-04-02",<br></br>        "cnpjEmissor": "12345678000123",<br></br>        "cnpjDestinatario": "12345678000112",<br></br>        "notasFiscais": [<br></br>            {<br></br>                "tipoRegistro": "02",<br></br>                "tipoFaturamento": "01",<br></br>                "numeroNf": "11111",<br></br>                "serieNf": "1",<br></br>                "tipoNf": "VENDA DE MERCADORIA ADQUIRIDA OU RECEBIDA DE TERCEIROS REMET",<br></br>                "dataEmissaoNf": "2025-04-02",<br></br>                "vendedor": {<br></br>                    "tipoRegistro": "02",<br></br>                    "nome": "JOSÉ JÚNIOR",<br></br>                    "codigo": "889"<br></br>                },<br></br>                "cliente": {<br></br>                    "tipoRegistro": "02",<br></br>                    "codigoCliente": "12.123.123/0001-23",<br></br>                    "cepCliente": "22555000",<br></br>                    "ufCliente": "SP",<br></br>                    "cidadeCliente": "SÃO PAULO - SP",<br></br>                    "enderecoCliente": "RODOVIA PRESIDENTE DUTRA",<br></br>                    "bairroCliente": "JARDIM BELA VISTA",<br></br>                    "nomeCliente": "CLIENTE EXEMPLO 01",<br></br>                    "telefoneCliente": "12345678"<br></br>                },<br></br>                "ufEmissorMercadoria": "RJ",<br></br>                "cepEmissorMercadoria": "11223344",<br></br>                "ufDestinatarioMercadoria": "RJ",<br></br>                "cepDestinatarioMercadoria": "22555000",<br></br>                "condicaoEntrega": "Sem frete",<br></br>                "diasPagamento": 0,<br></br>                "itens": [<br></br>                    {<br></br>                        "tipoRegistro": "03",<br></br>                        "produto": {<br></br>                            "tipoRegistro": "02",<br></br>                            "cnpjFornecedor": null,<br></br>                            "codigoProduto": "ABC-D",<br></br>                            "tipoItem": "01",<br></br>                            "quantidadeProdutoEmbalagem": null,<br></br>                            "precoTabelaUnidade": null,<br></br>                            "descricaoInternaItem": "MATERIAL EXEMPLO 01",<br></br>                            "statusProduto": "01"<br></br>                        },<br></br>                        "cfop": "5114",<br></br>                        "quantidadeVendida": 1.0,<br></br>                        "precoBruto": 350.00,<br></br>                        "bonificacao": "N",<br></br>                        "valorTotalBruto": 350.00,<br></br>                        "valorTotalLiquido": 350.00,<br></br>                        "valorIpi": 0.00,<br></br>                        "valorPis": 2.28,<br></br>                        "valorSubstituicaoTributaria": 0.00,<br></br>                        "valorIcms": 0.00,<br></br>                        "valorDescontos": 0.00<br></br>                    }<br></br>                ]<br></br>            },<br></br>            {<br></br>                "tipoRegistro": "02",<br></br>                "tipoFaturamento": "01",<br></br>                "numeroNf": "22222",<br></br>                "serieNf": "1",<br></br>                "tipoNf": "DEVOLUCAO SIMBOLICA DE MERCADORIA VENDIDA OU UTILIZADA EM PR",<br></br>                "dataEmissaoNf": "2025-04-02",<br></br>                "vendedor": null,<br></br>                "cliente": {<br></br>                    "tipoRegistro": "02",<br></br>                    "codigoCliente": "22.123.123/0001-23",<br></br>                    "cepCliente": "88559966",<br></br>                    "ufCliente": "RJ",<br></br>                    "cidadeCliente": "RESENDE - RJ",<br></br>                    "enderecoCliente": "RUA CADETE EDSON",<br></br>                    "bairroCliente": "MONTESE",<br></br>                    "nomeCliente": "CLIENTE EXEMPLO 02",<br></br>                    "telefoneCliente": "(24) 1111-2222"<br></br>                },<br></br>           "ufEmissorMercadoria": "RJ",<br></br>                "cepEmissorMercadoria": "11223344",<br></br>                "ufDestinatarioMercadoria": "RJ",<br></br>                "cepDestinatarioMercadoria": "22555000",<br></br>                "condicaoEntrega": "Sem frete",<br></br>                "diasPagamento": 0,<br></br>                "itens": [<br></br>                    {<br></br>                        "tipoRegistro": "03",<br></br>                        "produto": {<br></br>                            "tipoRegistro": "02",<br></br>                            "cnpjFornecedor": null,<br></br>                            "codigoProduto": "AB-CD",<br></br>                            "tipoItem": "01",<br></br>                            "quantidadeProdutoEmbalagem": null,<br></br>                            "precoTabelaUnidade": null,<br></br>                            "descricaoInternaItem": "MATERIAL EXEMPLO 01",<br></br>                            "statusProduto": "01"<br></br>                        },<br></br>                        "cfop": "1919",<br></br>                        "quantidadeVendida": 1.0,<br></br>                        "precoBruto": 300.00,<br></br>                        "bonificacao": "N",<br></br>                        "valorTotalBruto": 300.00,<br></br>                        "valorTotalLiquido": 300.00,<br></br>                        "valorIpi": 0.00,<br></br>                        "valorPis": 0.00,<br></br>                        "valorSubstituicaoTributaria": 0.00,<br></br>                        "valorIcms": 0.00,<br></br>                        "valorDescontos": 0.00<br></br>                    }<br></br>                ]<br></br>            }<br></br>        ]<br></br>    }<br></br>}
```

**2. Relatório de estoque (verificação de posição)**

- <span style="text-decoration: underline;">Requisição:</span>
    1. POST: \[URL BASE\]/v2-api/sellout/neogrid/estoque
    2. Authorization: Neogrid\[Token de integração do Fabricante\]
    3. Validação: Período não pode exceder 2 dias

```
{<br></br>    "dataInicial": "2026-03-05",<br></br>    "dataFinal": "2026-03-05"<br></br>}
```

- <span style="text-decoration: underline;">Retorno de requisição:</span>

```
{<br></br>    "relatorioEstoque": {<br></br>        "tipoRegistro": "01",<br></br>        "identificacao": "RELEST",<br></br>        "versao": "051",<br></br>        "numeroRelatorio": "01",<br></br>        "dataEmissao": "2026-03-05T11:04:55.202",<br></br>        "dataInicial": "2026-03-05",<br></br>        "dataFinal": "2026-03-05",<br></br>        "cnpjEmissor": "12345678000123",<br></br>        "cnpjDestinatario": "12123123000123",<br></br>        "estoque": [<br></br>            {<br></br>                "tipoRegistro": "02",<br></br>                "dataEstoque": "2026-03-05",<br></br>                "codigoItem": "156009",<br></br>                "lote": "MG16",<br></br>                "serial": null,<br></br>                "quantidadeEstoque": 0.00,<br></br>                "quantidadeEstoqueTransito": 0.00,<br></br>                "quantidadeEstoqueComprometido": 0.00,<br></br>                "produto": {<br></br>                    "tipoRegistro": "02",<br></br>                    "cnpjFornecedor": null,<br></br>                    "codigoProduto": "ABC-D",<br></br>                    "tipoItem": "01",<br></br>                    "quantidadeProdutoEmbalagem": null,<br></br>                    "precoTabelaUnidade": null,<br></br>                    "descricaoInternaItem": "MATERIAL EXEMPLO 01",<br></br>                    "statusProduto": "01"<br></br>                }<br></br>            },<br></br>            {<br></br>                "tipoRegistro": "02",<br></br>                "dataEstoque": "2026-03-05",<br></br>                "codigoItem": "156009",<br></br>                "lote": "PL12",<br></br>                "serial": null,<br></br>                "quantidadeEstoque": 0.00,<br></br>                "quantidadeEstoqueTransito": 0.00,<br></br>                "quantidadeEstoqueComprometido": 0.00,<br></br>                "produto": {<br></br>                    "tipoRegistro": "02",<br></br>                    "cnpjFornecedor": null,<br></br>                    "codigoProduto": "AB-CD",<br></br>                    "tipoItem": "01",<br></br>                    "quantidadeProdutoEmbalagem": null,<br></br>                    "precoTabelaUnidade": null,<br></br>                    "descricaoInternaItem": "MATERIAL EXEMPLO 02",<br></br>                    "statusProduto": "01"<br></br>                }<br></br>            }<br></br>        ]<br></br>    }<br></br>}
```