Histórico da Página
Considerações
01. DADOS GERAIS
Produto: |
| |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Linha de Produto: |
| |||||||||||
Segmento: |
| |||||||||||
Módulo: |
| |||||||||||
Função: | ProductionOrder | |||||||||||
País: | Brasil | |||||||||||
Ticket: | DMANSMARTSQUAD1-25267 | |||||||||||
Requisito/Story/Issue (informe o requisito relacionado) : |
...
Desenvolver API ProductionOrder para Inclusão inclusão e Alteração alteração da Situação situação das Ordens ordens de Produção produção no Logix.
03. SOLUÇÃO
Verbo: POST ({{host}}/api/supply/v1/productionOrder)
...
1) JSON para inclusão de ordem de produção:
{
"CompanyId":"01",
"ProductionOrderNumber":"",
"ItemCode":"11111",
"EndOrderDateTime":"2022-06-03T08:00:00",
"Quantity":"1",
"WarehouseCode":"01",
"RequestOrderCode":"DOCUM",
"StatusOrderType":"10",
"LotCode":"LOTE_1",
"ScriptCode":"01",
"AlternScriptCode":"0",
"ListOfItemGridsType":{
"ItemGrid": [
{
"GridCode":"AZUL",
"GridSequence":"1"
},
{
"GridCode":"1",
"GridSequence":"2"
}
]
}
}
2) JSON para alteração de situação da ordem de produção:
{
"CompanyId":"01",
"ProductionOrderNumber":"32484823",
"StatusOrderType":"7"
}
...
- Campos de entrada que deverão ser enviados no JSON de envio: . Se não for obrigatório, enviar a TAG nula, ou enviar conforme descrito abaixo:
TAGS | Descrição | Definição | Obrigatório? | Observação |
CompanyId | cod_empresa - Código da empresa | CHAR(02) | S | |
ProductionOrderNumber | Num_ordem - Número da ordem de produção | DECIMAL(10,0) | N | Obrigatório informar se TAG StatusOrderType diferente de 10 (Inclusão) |
ItemCode | Cod_item - Código do item | CHAR(15) | N | Obrigatório informar se TAG StatusOrderType igual a 10 (Inclusão) |
| Dat_entrega - Data de entrega | DATE | N | Obrigatório informar se TAG StatusOrderType igual a 10 (Inclusão) |
Quantity | Qtd_planej - Quantidade planejada | DECIMAL(10,3) | N | Obrigatório informar se TAG StatusOrderType igual a 10 (Inclusão) |
WarehouseCode | Cod_local_estoq - Local de estoque | CHAR(10) | N | Se não informado, considera local de estoque cadastrado para o item no Logix |
RequestOrderCode | Num_docum - Número de documento | CHAR(10) | N | |
StatusOrderType | Ies_situa – Situação da ordem de produção | INTEGER | S | 10 = Firme (Incluirá com situação 2 no Logix) 11 = Aberta (Modificará situação para 3 no Logix) 2 - Liberada (Modificará situação para 4 no Logix) 12 - Cancelada (Modificará situação para 9 no Logix) 7 - Encerrada (Modificará situação para 5 no Logix) |
LotCode | Num_lote - Número do Lote | CHAR(15) | N | |
ScriptCode | Cod_roteiro - Código do roteiro | CHAR(15) | N | Se não for informado, considera roteiro cadastrado para o item no Logix. |
AlternScriptCode | Num_altern_roteiro - Número roteiro alternativo | DECIMAL(2,0) | N | Se não for informado, considera número do roteiro alternativo cadastrado para o item no Logix. |
ListOfItemGridsType / ItemGrid/ GridCode | Cod_grade – código da grade | CHAR(15) | N | Obrigatório informar se TAG StatusOrderType StatusOrderType igual a 10 (Inclusão) e item possuir controle de grade. |
ListOfItemGridsType / ItemGrid/ GridSequence | Sequencia_grade (1 a 5) | INTEGER | N | Obrigatório informar se TAG StatusOrderType igual a 10 (Inclusão) e item possuir controle de grade. |
...
- Todos os campos enviados acima serão consistidos conforme regras existentes no programa MAN10031.
- Para a ação de inclusão (StatusOrderType = 10), será necessário o envio de todas as informações obrigatórias conforme descrito na planilha no quadro acima.
- Para as ações de alteração de status (StatusOrderType = 2, 7, 11 ou 12), será necessário o envio apenas das informações de cod_empresa, num_ordem e ies_situa, e o sistema irá realizar realizará as consistências para alteração da situação da ordem conforme regras já utilizadas no programa MAN10055.
- Ao apresentar a primeira inconsistência, o programa ira retornar retornará com um status ERRO e a respectiva mensagem correspondente ao erro encontrado, cancelando a ação.
- O sistema encaminhará JSON de retorno com resultado da ação no Logix (sucesso ou erro), mensagem, número e situação da ordem de produção.
JSON de Retorno:
{
"code": "200",
"message": "Inclusão efetuada com sucesso.",
"ProductionOrderNumber": " 32485919",
"StatusOrderType": " 10"
}
...
- Detalhes de como habilitar o serviço de API’s APIs podem ser consultadas em: https://tdn.totvs.com/pages/viewpage.action?pageId=185747842
...