Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Método que permite consultar as divergências de cargas de recebimento do WMS Centro de Distribuição. 

Esse tipo de exportação ocorre ao emitir o termo de liberação, quando a Empresa não utiliza o ERP TOTVS Varejo Supermercados.


Em WMS Parâmetros >Parâmetro > Dinâmico:

O parâmetro EXP_INFO_TOTAL_REC determinará se todas as informações da Carga de Recebimento serão exportadas, mesmo se não houver divergência.

O parâmetro EXP_DIV_REC_AREA determinará se a exportação será realizada por Área de Armazenagem. Quando for utilizado o conceito de Sorter, essa parametrização deverá estar definida com 'S', pois os retornos das conferências deverão ser por Área de Armazenagem (Lojas).

Chamada

GET api/v1/exportacao/divergenciarecebimento

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
page

Número da página.

integer

Valor inicial: 1. Valor padrão: 1

pagesize

Número de itens a serem retornados por página.

integerValor limite: 100. Valor padrão: 10.
fields

Nome dos campos a serem retornados. Podem ser enviados múltiplos campos, separando-os por vírgula.

stringQuando não enviado, retorna todos.
order

Nome dos campos utilizados para ordenação da lista. Podem ser enviados múltiplos campos, separando-os por vírgula.
Quando utilizado junto ao parâmetro fields, terá efeito apenas nos campos nele informados. 
Para ordenação decrescente, utilizar o caractere hífen (-) antes do campo. Exemplo: -seqexportacao.

string

Quando não enviado, utiliza ordenação padrão da base de dados.

nroempresaFiltro para busca de divergências de recebimento de determinada empresa.integerQuando não enviado, retorna de todas as empresas.
nrocargaFiltro para busca de divergências de determinada carga.integerOpcional.
numeronfFiltro para busca de divergências de recebimento com determinado número de nota fiscal.integerOpcional.
serienfFiltro para busca de divergências de recebimento com determinada série de nota fiscal (utilizado em conjunto com numeronf).integerOpcional.
status

Filtro para busca de registros com determinados status:

A - Aguardando/Não Integrado 
F - Finalizada/Integrado

stringValor padrão: A
datainicioFiltro para busca de registros a partir de determinada data, no formato 2022-12-01T13:00:00 datetimeQuando não enviado, retorna
todas
todos os registros, independente da data.
datafimFiltro para busca de registros até determinada data, no formato 2022-12-01T13:00:00 datetimeQuando não enviado, retorna
todas
todos os registros, independente da data.

Parâmetros do Corpo (Body Parameters)

...

Corpo da Resposta (Response Body):

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
hasNext

Indica a existência de uma próxima página.

boolean

true: indica que existe uma próxima página;
false: indica que é a última página.

items

Lista de divergências de recebimento.

ArrayDetalhamento de cada item (Divergência) da lista, conforme
tabela
tabelas abaixo.

Divergência de Recebimento:

Quando utilizado o parâmetro dinâmico EXP_DIV_REC_AREA igual a S:

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
SEQEXPORTACAONúmero sequencial correspondente ao registro de exportação.longÉ utilizado para realizar a confirmação de leitura do registro.
NROEMPRESANúmero da empresa logística no WMS Centro de Distribuição.integer
NROCARGANúmero da carga.long
SEQPRODUTOCódigo sequencial do produto.long
QTDEMBALAGEMQuantidade de unidades dentro de cada embalagem.decimal
CODDEPOSITANTENúmero da empresa ou código do depositante (quando utilizado Operador Logístico).integer
AREAARMAZENAGEMCódigo da área de armazenagem para a qual foi conferida a quantidade recebida do produto.string
QTDDOCUMENTO

Quantidade da nota fiscal.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDRECEBIDA

Quantidade conferida.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDDIVERGENTE

Quantidade divergente entre a quantidade informada na nota fiscal e a quantidade conferida.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
DTAVALIDADE

Data de validade.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_DTAVALIDADE estiver com o valor igual a S.

datetime
DTAFABRICACAO

Data de fabricação.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_DTAFABRICACAO estiver com o valor igual a S.

datetime
NROLOTE

Lote de fabricação.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_LOTEFABRICACAO estiver com o valor igual a S.

string
SEQPALETERF

Número do palete.

SSCC número sequencial do palete.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_PALETE estiver com o valor igual a S.

string
INDQUARENTENA

Indicador que diz se o produto recebido está em quarentena.
S – Sim
N – Não.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_INDQUARENTENA estiver com o valor igual a S.

string
DTAHORGERACAOData e hora de geração do registro.datetime
Exemplo de Resposta:
Bloco de código
languageactionscript3
{
    "hasNext": true,
    "items": [
        {
            "SEQEXPORTACAO": 11,
            "NROEMPRESA": 100,
            "NROCARGA": 500032,
            "SEQPRODUTO": 12067,
            "QTDEMBALAGEM": 1000.0,
            "CODDEPOSITANTE": 100,
            "AREAARMAZENAGEM": "P",
            "QTDDOCUMENTO": 1000.0,
            "QTDRECEBIDA": 1000.0,
            "QTDDIVERGENTE": 0.0,
            "DTAVALIDADE": "2026-01-01T00:00:00",
            "DTAFABRICACAO": "2022-12-23T00:00:00",
            "NROLOTE": "1234",
            "SEQPALETERF": "2329",
            "INDQUARENTENA": "N", 
            "DTAHORGERACAO": "2022-12-23T08:58:05",
            "_expandables": []
        }
    ]
}

Quando utilizado o parâmetro dinâmico EXP_DIV_REC_AREA igual a N:

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
SEQEXPORTACAONúmero sequencial correspondente ao registro de exportação.longÉ utilizado para realizar a confirmação de leitura do registro.
NROEMPRESANúmero da empresa logística no WMS Centro de Distribuição.integer
NROCARGANúmero da carga.long
SEQPRODUTOCódigo sequencial do produto.long
QTDEMBALAGEMQuantidade de unidades dentro de cada embalagem.decimal
CODDEPOSITANTENúmero da empresa ou código do depositante (quando utilizado Operador Logístico).integer
QTDDOCUMENTO

Quantidade da nota fiscal.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDRECAVARIADA

Quantidade é conferida na área de armazenagem AVARIA.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDDIVERGENTE

Quantidade divergente entre a quantidade informada na nota fiscal e a quantidade conferida.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDRECRECICLAGEM

Quantidade é conferida na área de armazenagem RECICLAGEM.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
DTAVALIDADE

Data de validade.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_DTAVALIDADE estiver com o valor igual a S.

datetime
DTAFABRICACAO

Data de fabricação.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_DTAFABRICACAO estiver com o valor igual a S.

datetime
NROLOTE

Lote de fabricação.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_LOTEFABRICACAO estiver com o valor igual a S.

string
SEQPALETERF

Número do palete.

SSCC número sequencial do palete.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_PALETE estiver com o valor igual a S.

string
INDQUARENTENA

Indicador que diz se o produto recebido está em quarentena.
S – Sim
N – Não.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_INDQUARENTENA estiver com o valor igual a S.

string
DTAHORGERACAOData e hora de geração do registro.datetime
Exemplo de Resposta:
Bloco de código
languageactionscript3
{
    "hasNext": true,
    "items": [
        {
            "SEQEXPORTACAO": 16,
            "NROEMPRESA": 100,
            "NROCARGA": 500034,
            "SEQPRODUTO": 42716,
            "QTDEMBALAGEM": 44.0,
            "CODDEPOSITANTE": 100,
            "QTDDOCUMENTO": 88.0,
            "QTDRECAVARIADA": 0.0,
            "QTDDIVERGENTE": -44.0,
            "QTDRECRECICLAGEM": 0.0,
            "DTAVALIDADE": "2026-01-01T00:00:00",
            "DTAFABRICACAO": "2022-12-23T00:00:00",
            "NROLOTE": "1234",
            "SEQPALETERF": "2329",
            "INDQUARENTENA": "N",
            "DTAHORGERACAO": "2022-12-23T10:50:09",
        }
    ]
}

Divergências por Nota Fiscal - Quando utilizado o parâmetro "Gera Cargas de Recebimento" marcado (WMS Parâmetros > Parâmetro > Geral > Aba Recebimento):

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
SEQEXPORTACAONúmero sequencial correspondente ao registro de exportação.longÉ utilizado para realizar a confirmação de leitura do registro.
NROEMPRESANúmero da empresa logística no WMS Centro de Distribuição.integer
NROCARGANúmero da carga.long
SEQPRODUTOCódigo sequencial do produto.long
QTDEMBALAGEMQuantidade de unidades dentro de cada embalagem.decimal
QTDDOCUMENTO

Quantidade da nota fiscal.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
QTDRECEBIDA

Quantidade conferida.

O valor a receber será enviado na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600.

decimal
DTAVALIDADE

Data de validade.

Esta informação somente será enviada caso o parâmetro dinâmico EXP_DTAVALIDADE estiver com o valor igual a S.

datetime
NUMERONFNúmero da nota fiscal de entrada.long
SERIENFSérie da nota fiscal de entrada.string
NROPEDCOMPRA

Número do pedido de compras.

long
SEQFORNECEDORCódigo ou CNPJ do fornecedor.long
SEQITEMNFNúmero sequencial do item dentro da nota fiscal.long
DTAHORGERACAOData e hora de geração do registro.datetime
Exemplo de Resposta:
Bloco de código
languageactionscript3
{
    "hasNext": true,
    "items": [
        {
            "SEQEXPORTACAO": 17,
            "NROEMPRESA": 100,
            "NROCARGA": 9,
            "SEQPRODUTO": 12378,
            "QTDEMBALAGEM": 50.0,
            "QTDDOCUMENTO": 450.0,
            "QTDRECEBIDA": 150.0,
            "DTAVALIDADE": "2026-01-01T00:00:00", 
            "NUMERONF": 118076,
            "SERIENF": "001",
            "NROPEDCOMPRA": 7295715,
            "SEQFORNECEDOR": 10298,
            "SEQITEMNF": 1,
            "DTAHORGERACAO": "2022-12-23T11:37:13",
        }
    ]
}