# 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>}
```