Linha Logix

Páginas filhas
  • DT DMANSMARTSQUAD1-25267 - API Inclusão/Manutenção Ordens de Produção

Considerações 

01. DADOS GERAIS

Produto:

TOTVS Manufatura




Linha de Produto:

Linha Logix

Segmento:

Manufatura

Módulo:

TOTVS Manufatura (Linha Logix) - Plano Operacional

Função:ProductionOrder
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DMANSMARTSQUAD1-25267


02. SITUAÇÃO/REQUISITO

Desenvolver API ProductionOrder para inclusão e alteração da situação das ordens de produção no Logix.

03. SOLUÇÃO

Verbo: POST ({{host}}/api/supply/v1/productionOrder) 


JSON de Envio:

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"
}


Informações das TAGS do JSON de envio:

  • 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)



EndOrderDateTime


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 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.

Considerações:

As seguintes regras estão previstas: 

  • 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 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 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 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"
}

Importante:

  • Os dados das entidades gravadas na ordem de produção (por exemplo: código de item, local de estoque, etc) deverão vir conforme códigos existentes no ERP Logix.
  • Manutenções das ordens de produção serão realizadas pelo ERP Logix em seus processos padrões.

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

  • Não se aplica.