English
Español
Integração YMS x WMS Senior
O processo se inicia com a chegada do caminhão à portaria do armazém, onde é apresentada a nota fiscal de entrada, e o sistema Gestão de Pátio realiza uma consulta no sistema Gestão de Armazenagem | WMS Senior que verifica se a nota fiscal já está planejada em uma OR (Ordem de Recebimento). O Gestão de Armazenagem | WMS Senior fornece apenas informações sobre a nota fiscal e a OR (Ordem de Recebimento), sem interferir no processo de recebimento do WMS. Por outro lado, o sistema Gestão de Pátio pode ser configurado para bloquear a entrada do caminhão no armazém caso a OR (Ordem de Recebimento) não esteja planejada.
Particularidades
Requisitos- Gestão de Pátio devidamente configurado com a ApiKey fornecida pelo Gestão de Armazenagem | WMS Senior
- Existir a Nota Fiscal consultado no Gestão de Armazenagem | WMS Senior
- Chave de Acesso válida com 44 caracteres
CompatibilidadeEsta funcionalidade será compatível com as versões superiores a 8.12.7.244 do Gestão de Armazenagem | WMS Senior.
(Referente WMS-12242)
Parametrizações
Configuração GeralAcesse Configuração > Configuração Geral > guia Rest
- ApiKey - chave utilizada para sistema de terceiros consumirem serviços Rest: chave utilizada para o sistema de terceiros consumirem serviços Rest.
Consulta
Ordem de Recebimento Será enviado para consulta (em estrutura JSON) apenas uma nota fiscal por consulta. "documentKey" = "Chave de Acesso NF-e".
Observação: só será retornado dados de notas ficais do tipo entrada.
Parâmetros para comunicaçãoMétodo: Post
URL: /webresources/rest/v2/yms/ornf
Headers:
- Content-Type: application/JSON
- Apikey: chave utilizada para o sistema de terceiros consumirem serviços Rest
Envio
JSON
{
"documentKey": "42230680680093110181050010001122041395240230"
}
Retorno
Status: 200Ordem de Recebimento encontrada com nota fiscal vinculada
{
"invoiceNumber": 24030801",
"invoiceKey": "35160694497362000183550748949811149008032401",
"invoiceSerialNumber": "1",
"logistcUnitName":"Armazem",
"logistcUnitDocument":"88.888.888/0001-88",
"ownerName": "Depositante",
"ownerDocument: "99.999.999/0001-99",
"partnerName": "Depositante",
"partnerDocument: 99.999.999/0001-99",
"orderReceivingCode": 113,
"notes": Envio de OR"
}
| Campo | Descrição |
|---|---|
| invoiceNumber | Número do Código Interno da NF-e |
| invoiceKey | Chave de Acesso da NF-e |
| invoiceSerialNumber | Sequência |
| logistcUnitName | Descrição do Armazém |
| logistcUnitDocument | CNPJ do Armazém |
| ownerName | Razão Social do Depositante |
| ownerDocument | CNPJ do Depositante |
| partnerName | Razão Social do Emitente da Nota Fiscal |
| partnerDocument | CNPJ do Emitente |
| orderReceivingCode | Número da Ordem de Recebimento, quando houver |
| notes | Observação cadastrada na Ordem de Recebimento, quando houver |
| notes | Mensagem tratada pelo sistema |
Status: 200Ordem de Recebimento não encontrada
{
"invoiceNumber": 24020750",
"invoiceKey": "42260694497362000183550748949811149008032240",
"invoiceSerialNumber": "1",
"logistcUnitName":"Armazem",
"logistcUnitDocument":"88.888.888/0001-88",
"ownerName": "Depositante",
"ownerDocument: "99.999.999/0001-99",
"partnerName": "Depositante",
"partnerDocument: 99.999.999/0001-99",
"message": Não existe Ordem de Recebimento para esta Nota Fiscal"
}
Status: 404Não encontrada Nota Fiscal para a chave de acesso
{
"message": "Não existe Ordem de Recebimento para esta Nota Fiscal.",
"errorCode": "404",
"reason": "Note Found"
}
Status: 500Apikey inválida
{
"statusCode": "500",
"statusDescription": "Internal Server Error",
"errorMessage": "ApiKey informada é inválida",
"clazz": "br.com.senior.webframework.cliente.core.exception.DefautClientException"
}
Status: 400Sem documentkey
{
"message": "O campo 'documentKey' é obrigatório.",
"errorCode": "400",
"reason": "Bad Request"
}
Status: 400Com mais de uma OR
{
"message": "O corpo da solicitação deve conter apenas um 'documentKey'.",
"errorCode": "400",
"reason": "Bad Request"
}
S I M P L I F I C A N D O- O caminhão entrega a Nota Fiscal de Entrada para a portaria do armazém.
- O responsável consulta no Gestão de Pátio através da chave de acesso os dados da Ordem de Recebimento.
- O Gestão de Armazenagem | WMS Senior retorna as informações da Nota Fiscal e do Planejamento da Ordem de Recebimento.
- O responsável libera o acesso do caminhão ao Pátio.
English
Español
