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

Versões comparadas

Chave

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

Considerações 

01. DADOS GERAIS

Produto:

Solucoes_totvs
Solucao TOTVS Manufatura




Linha de Produto:

Linhas_totvs
LinhaLinha Logix

Segmento:

Segmentos_totvs
SegmentoManufatura

Módulo:

Modulos_cross_segmentos

Modulos_framework

Modulos_totvs_construcao

Modulos_totvs_juridico

Modulos_totvs_logistica

Modulos_totvs_manufatura
ModulosTOTVSManufaturaTOTVS Manufatura (Linha Logix) - Plano Operacional

Modulos_totvs_rh

Modulos_totvs_saude

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)



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

...

...