Integração com Neogrid
Sincronia entre Consumo e Reposição
A integração entre o V2Saúde e a Neogrid 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 demanda real. 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 V2Saúde processa e responde automaticamente às consultas da Neogrid, 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 demanda real, 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 > Empresa e preferências;
- Acesse a aba "Integrações" e selecione SIM para 'Integração com Neogrid?';
- Após esta etapa basta acessar o cadastro do Fabricante em Estoque > Fabricante;
- Clique em 'Editar';
- No cadastro do fabricante clique em 'Gerar novo token' para gerar o token de identificação que será utilizado nas consultas da Neogrid.
- Sinalize a caixa 'Ativar Sell Out nas notas emitidas com produtos deste fabricante?' e posteriormente em 'Salvar'.
Documentação Técnica: API de Consumo de Dados Neogrid
1. Relatório de vendas (verificação de consumo)
- Requisição:
-
- POST: [URL BASE]/v2-api/sellout/neogrid/notas
-
Authorization: Neogrid[Token de integração do Fabricante]
-
Validação: Período não pode exceder 90 dias
{
"dataInicial": "2025-04-02",
"dataFinal": "2025-04-02"
}- Retorno de requisição:
{
"relatorioVendas": {
"tipoRegistro": "01",
"identificacao": "VENDAS",
"versao": "052",
"numeroRelatorio": "01",
"dataEmissao": "2026-03-05T10:46:35.9",
"dataInicialPeriodoVenda": "2025-04-02",
"dataFinalPeriodoVenda": "2025-04-02",
"cnpjEmissor": "12345678000123",
"cnpjDestinatario": "12345678000112",
"notasFiscais": [
{
"tipoRegistro": "02",
"tipoFaturamento": "01",
"numeroNf": "11111",
"serieNf": "1",
"tipoNf": "VENDA DE MERCADORIA ADQUIRIDA OU RECEBIDA DE TERCEIROS REMET",
"dataEmissaoNf": "2025-04-02",
"vendedor": {
"tipoRegistro": "02",
"nome": "JOSÉ JÚNIOR",
"codigo": "889"
},
"cliente": {
"tipoRegistro": "02",
"codigoCliente": "12.123.123/0001-23",
"cepCliente": "22555000",
"ufCliente": "SP",
"cidadeCliente": "SÃO PAULO - SP",
"enderecoCliente": "RODOVIA PRESIDENTE DUTRA",
"bairroCliente": "JARDIM BELA VISTA",
"nomeCliente": "CLIENTE EXEMPLO 01",
"telefoneCliente": "12345678"
},
"ufEmissorMercadoria": "RJ",
"cepEmissorMercadoria": "11223344",
"ufDestinatarioMercadoria": "RJ",
"cepDestinatarioMercadoria": "22555000",
"condicaoEntrega": "Sem frete",
"diasPagamento": 0,
"itens": [
{
"tipoRegistro": "03",
"produto": {
"tipoRegistro": "02",
"cnpjFornecedor": null,
"codigoProduto": "ABC-D",
"tipoItem": "01",
"quantidadeProdutoEmbalagem": null,
"precoTabelaUnidade": null,
"descricaoInternaItem": "MATERIAL EXEMPLO 01",
"statusProduto": "01"
},
"cfop": "5114",
"quantidadeVendida": 1.0,
"precoBruto": 350.00,
"bonificacao": "N",
"valorTotalBruto": 350.00,
"valorTotalLiquido": 350.00,
"valorIpi": 0.00,
"valorPis": 2.28,
"valorSubstituicaoTributaria": 0.00,
"valorIcms": 0.00,
"valorDescontos": 0.00
}
]
},
{
"tipoRegistro": "02",
"tipoFaturamento": "01",
"numeroNf": "22222",
"serieNf": "1",
"tipoNf": "DEVOLUCAO SIMBOLICA DE MERCADORIA VENDIDA OU UTILIZADA EM PR",
"dataEmissaoNf": "2025-04-02",
"vendedor": null,
"cliente": {
"tipoRegistro": "02",
"codigoCliente": "22.123.123/0001-23",
"cepCliente": "88559966",
"ufCliente": "RJ",
"cidadeCliente": "RESENDE - RJ",
"enderecoCliente": "RUA CADETE EDSON",
"bairroCliente": "MONTESE",
"nomeCliente": "CLIENTE EXEMPLO 02",
"telefoneCliente": "(24) 1111-2222"
},
"ufEmissorMercadoria": "RJ",
"cepEmissorMercadoria": "11223344",
"ufDestinatarioMercadoria": "RJ",
"cepDestinatarioMercadoria": "22555000",
"condicaoEntrega": "Sem frete",
"diasPagamento": 0,
"itens": [
{
"tipoRegistro": "03",
"produto": {
"tipoRegistro": "02",
"cnpjFornecedor": null,
"codigoProduto": "AB-CD",
"tipoItem": "01",
"quantidadeProdutoEmbalagem": null,
"precoTabelaUnidade": null,
"descricaoInternaItem": "MATERIAL EXEMPLO 01",
"statusProduto": "01"
},
"cfop": "1919",
"quantidadeVendida": 1.0,
"precoBruto": 300.00,
"bonificacao": "N",
"valorTotalBruto": 300.00,
"valorTotalLiquido": 300.00,
"valorIpi": 0.00,
"valorPis": 0.00,
"valorSubstituicaoTributaria": 0.00,
"valorIcms": 0.00,
"valorDescontos": 0.00
}
]
}
]
}
}2. Relatório de estoque (verificação de posição)
- Requisição:
- POST: [URL BASE]/v2-api/sellout/neogrid/estoque
-
Authorization: Neogrid[Token de integração do Fabricante]
-
Validação: Período não pode exceder 2 dias
{
"dataInicial": "2026-03-05",
"dataFinal": "2026-03-05"
}- Retorno de requisição:
{
"relatorioEstoque": {
"tipoRegistro": "01",
"identificacao": "RELEST",
"versao": "051",
"numeroRelatorio": "01",
"dataEmissao": "2026-03-05T11:04:55.202",
"dataInicial": "2026-03-05",
"dataFinal": "2026-03-05",
"cnpjEmissor": "12345678000123",
"cnpjDestinatario": "12123123000123",
"estoque": [
{
"tipoRegistro": "02",
"dataEstoque": "2026-03-05",
"codigoItem": "156009",
"lote": "MG16",
"serial": null,
"quantidadeEstoque": 0.00,
"quantidadeEstoqueTransito": 0.00,
"quantidadeEstoqueComprometido": 0.00,
"produto": {
"tipoRegistro": "02",
"cnpjFornecedor": null,
"codigoProduto": "ABC-D",
"tipoItem": "01",
"quantidadeProdutoEmbalagem": null,
"precoTabelaUnidade": null,
"descricaoInternaItem": "MATERIAL EXEMPLO 01",
"statusProduto": "01"
}
},
{
"tipoRegistro": "02",
"dataEstoque": "2026-03-05",
"codigoItem": "156009",
"lote": "PL12",
"serial": null,
"quantidadeEstoque": 0.00,
"quantidadeEstoqueTransito": 0.00,
"quantidadeEstoqueComprometido": 0.00,
"produto": {
"tipoRegistro": "02",
"cnpjFornecedor": null,
"codigoProduto": "AB-CD",
"tipoItem": "01",
"quantidadeProdutoEmbalagem": null,
"precoTabelaUnidade": null,
"descricaoInternaItem": "MATERIAL EXEMPLO 02",
"statusProduto": "01"
}
}
]
}
}