Histórico da Página
Objetivo
Método que permite inserir carga de recebimento.
Chamada
POST api/v1/importacao/recebimento Informações para Requisição (Request Information)
Parâmetros URI (URI Parameters)
Não há.
Parâmetros do Corpo (Body Parameters)
| Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
| NROCARGA* | Número da carga. É o número sequencial que agrupa as Notas Fiscais de Entrada por Caminhão. | integer | |
| NROEMPRESA* | Número da Empresa Logística. | integer | Valor Máximo: 999999 |
| DESCRICAO* | Descrição que identificará a carga de recebimento. | string | Tamanho Máximo: 40 |
| TIPCARGARECEB* | Tipo de carga de recebimento: C – Compras/Transferências D – Devolução. | string | Tamanho Máximo: 1 |
| NROBOX | Número do box que será utilizado para o recebimento da carga. | integer | Valor Máximo: 999 |
| USUGERACAO | Usuário de geração da carga de recebimento. | string | Tamanho Máximo: 12 |
| RECADO | Recado | string | Tamanho Máximo: 250 |
| NROCARGAEXPED | Número da carga de expedição que gerou a carga de recebimento. | integer | |
| NROEMPRESAEXPED | Código da empresa da carga de expedição que gerou a carga de recebimento. | integer | Valor Máximo: 999999 |
| CODPRODUTIVOCONFER | Código do produtivo que realizou a conferência de devolução. | integer | |
| CODPRODUTIVODIGIT | Código do produtivo que digitou a conferência de devolução. | integer | |
| SEQFORNECEDOR | Código ou CNPJ do fornecedor (conforme já enviado na integração de cadastro). Não é obrigatório, mas quando informado, indica que a carga será considerada no processo Separação na Seleção Inversa. | integer |
*Campos Obrigatórios.
Itens
Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
|---|---|---|---|
| CODDEPOSITANTE* | Número da empresa ou código do depositante(quando utiliza Operador Logístico). | integer | Valor Máximo: 999999 |
| AREAARMAZENAGEM* | Código da área de armazenagem para a qual, a princípio, será destinada a quantidade recebida do produto, previamente cadastrado no ACRUX LOCUS PARÂMETRO / Áreas de Armazenagem. | string | Tamanho Máximo: 6 |
| SEQPRODUTO* | Código sequencial do produto. | integer | |
| QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem. | decimal | Valor Máximo: 99999,999 |
| QTDDOCUMENTO* | Quantidade de unidades a receber do produto para esta carga/empresa/depositante/área de armazenagem. O valor a receber deverá vir na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600. | decimal | Valor Máximo: 999999999,999 |
| NROEMPRESAITEMREC | Número da empresa do item a ser armazenado. Obrigatório o envio quando utiliza uma empresa logística para mais de uma empresa comercial. | integer | |
| INDEXIGETEMPERATURA | Indicador para que seja exigida a temperatura durante a conferência de recebimento. | string | Tamanho Máximo: 1 |
| VLRITEMCUSTO | Valor de custo do item. | decimal | Valor Máximo: 9999999999,99 |
| QTDTOTALDOCUMENTO | Quantidade de documento total em unidades a receber do produto para esta carga e empresa. Esta informação deverá ser enviada quando utilizado o conceito de enviar as quantidades por área de armazenagem (loja), onde o sistema realizará uma validação se a quantidade por área de armazenagem está igual a quantidade total. O valor a receber deverá vir na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600. | decimal | Valor Máximo: 999999999,999 |
*Campos Obrigatórios.
ItensConferencia
Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
|---|---|---|---|
| QTDRECEBIDA* | Quantidade de unidades recebida do produto para esta carga/empresa/depositante/área de armazenagem/validade. O valor recebido deverá vir na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600. | decimal | Valor Máximo: 999999999,999 |
| DTAVALIDADE* | Data de validade do produto que foi recebido. | date | |
| NROLOTE* | Código do lote de fabricação do produto que foi recebido. | string | Tamanho Máximo: 20 |
*Campos Obrigatórios.
ItensControlaLote
Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
|---|---|---|---|
| QTDDOCUMENTO* | Quantidade de unidades a receber do produto para esta carga/empresa/depositante/área de armazenagem/lote de fabricação. O valor a receber deverá vir na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600. | decimal | Valor Máximo: 999999999,999 |
| DTAVALIDADE* | Data de validade do produto a receber. | date | |
| NROLOTE* | Código do lote de fabricação do produto a receber. | string | Tamanho Máximo: 20 |
*Campos Obrigatórios.
Paletes
Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
|---|---|---|---|
| SEQPALETERF | Número do palete. Número sequencial do palete. Para utilizar o SEQPALETERF deve ser informado o valor ‘S’ no campo INDTIPOCODPALETE. O código do sequencial de palete deve ser um número inteiro e não pode ter mais que 15 caracteres. Quando for informado, o campo CODSERIEUNIDADELOGISTICA deverá ser nulo. | integer | |
| CODSERIEUNIDADELOGISTICA | Código do Palete SSCC. Para utilizar o CODSERIEUNIDADELOGISTICA deve ser informado o valor ‘C’ no campo INDTIPOCODPALETE. O código desse palete deve ser um número inteiro e não pode ter mais que 20 caracteres. Quando for informado o campo SEQPALETERF deverá ser nulo. | string | Tamanho Máximo: 20 |
| QUANTIDADE* | Quantidade de unidades a receber do produto para esta carga/empresa/depositante/área de armazenagem/palete. O valor a receber deverá vir na quantidade unitária, por exemplo, para 50 CX12, deverá ser enviado 600. | decimal | Valor Máximo: 999999999,999 |
| DTAFABRICACAO* | Data de fabricação do produto a receber. | date | |
| DTAVALIDADE* | Data de validade do produto a receber. | date | |
| NROLOTE* | Código do lote de fabricação do produto a receber. | string | Tamanho Máximo: 20 |
| INDTIPOCODPALETE* | Indica se o código de Palete a ser usado será o sequencial de Palete( valor ‘S’) ou SSCC( valor ‘C’) | string | Tamanho Máximo: 1 |
Formatos de Request(Request Formats)
application/json, text/json
| Bloco de código | ||
|---|---|---|
| ||
{
"nroEmpresa": 100,
"nroCarga": 1048,
"descricao": "TESTEQAWMS",
"tipCargaReceb": "C",
"nroCargaExped": 845,
"usuGeracao": "Consinco",
"recado": "TESTE",
"nroBox": 1,
"codProdutivoConfer": 7,
"codProdutivoDigit": 7,
"nroEmpresaExped": 100,
"seqFornecedor": 1,
"itens": [
{
"codDepositante": 1,
"areaArmazenagem": "s",
"seqProduto": 1414,
"qtdEmbalagem": 10,
"qtdDocumento": 75,
"nroEmpresaItemRec": 100,
"indexIgeTemperatura": "s",
"vlrItemCusto": 99,
"qtdTotalDocumento": 75,
"itensConferencia": [
{
"qtdRecebida": 10,
"dtaValidade": "2025-05-30T12:38:05.080Z",
"nroLote": "TOTVSMOV",
"expandables": [
"string"
]
}
],
"itensControlaLote": [
{
"qtdDocumento": 75,
"dtaValidade": "2025-05-30T12:38:05.080Z",
"nroLote": "TESTEQA",
"expandables": [
"string"
]
}
],
"paletes": [
{
"codSerieUnidadeLogistica": "3057",
"quantidade": 1920,
"dtaFabricacao": "2023-05-30",
"dtaValidade": "2025-05-30",
"nroLote": "totvs",
"indTipoCodPalete": "C"
}
]
}
]
} |
Informações para Resposta (Response Information)
Códigos do Recurso (Response Codes)
- OK (201)
- BadRequest (400)
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas