Linha de Produto: | TOTVS Varejo Lojas |
---|---|
Segmento: | Varejo |
Módulo: | SigaLoja (Controle de Loja) |
Função: | RmiEnvPdvSyncObj |
Ticket: | Não há. |
Story: | DVARLOJ1-8248 |
Disponibilizar alguma maneira de consultar as notas fiscais de saída, onde seja possível visualizar os itens que já foram devolvidos
Foi disponibilizada API no seguinte caminho: http://{urlRest}/api/retail/v1/notasaida/lista
A API utiliza o método POST, caso queria informar parâmetros para filtro os mesmos devem ser passados no corpo.
Exemplo:
{
"dataInicio": "20190101",
"dataFim": "20190130"
}
Parâmetros de entrada (Request):
Parâmetro | Tipo | Obrigatório | Objetivo |
dataInicio | Data | SIM, quando não informado o cupom | Filtrar data da venda |
dataFim | Data | SIM, quando não informado o cupom | Filtrar data da venda |
cpfCnpj | String | N | Pesquisar com base no CPF informado no Cupom ou com base no código do cliente identificado na venda que possui o CPF informado na pesquisa |
serie | String | N | Serie documento fiscal, algo interno do Protheus(F2_SERIE), exemplo: SAT não possui série de documento, possui serial apenas de equipamento. |
cupom | String | N | Número do documento fiscal (não precisa informar a série, se informar apenas o cupom, deverá retornar todos os cupons com o mesmo número, não importa a série). Não devemos obrigar informar zeros a esquerda se o Protheus gravar com zeros, devemos abstrair essa regra. |
IdRetaguardaProduto | String | N | Id do Produto (mesmo formato que enviamos o produto na integração) |
IdRetaguardaLojaCupom | String | N | Id da Loja que emitiu o cupom, será utilizado para pesquisar o documento da SF2 (esse campo será utilizado para identificar o cupom quando for gerar o Crédito/Nota de Entrada) |
tipo | Array Enum | N | Permitir filtrar somente alguns tipos de cupons, exemplo: O PDV OMNISHOP não emite NF-e, ou seja, se passar no filtro que deseja somente NFC-e e SAT, não iremos devolver vendas NF-e gravadas no ERP. |
pagina | Int | N | Quando possuir paginação, informar a página. |
itensPagina | Int | N | Quantidade de itens que serão retornados por página. |
Retorno:
{
"data": [
{
"descricao": " ",
"idRetaguardaLoja": "D MG 01 ",
"dataHora": "2019011109:27",
"idRetaguardaCupomItem": "D MG 01 15 LOJ01",
"situacao": "disponível ",
"cpdCnpj": "26865525140 ",
"valorTotal": 10,
"tipo": "CF ",
"valorUnitario": 10,
"qtdVendida": 1,
"qtdItens": 1,
"serie": "LOJ",
"qtdDisponivel": 1,
"idRetaguardaCupom": "D MG 01 15 LOJ",
"cupom": "15 ",
"idRetaguardaProduto": "LOTE "
}
],
"message": "",
"success": true,
"hasNext": true
}
<style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { background: #FF9900; !important } .menu-item.active-tab { border-bottom: none !important; } </style> |