DT DMANSMARTSQUAD1-27021 - API ProductionAppointment - Documentação e Exemplo

01. DADOS GERAIS

Produto:	TOTVS Manufatura
Linha de Produto:	Linha Logix
Segmento:	Manufatura
Módulo:	TOTVS Manufatura (Linha Logix) - Chão de Fábrica
Função:	API ProductionAppointment
País:	Brasil
Issue:	DMANSMARTSQUAD1-27021

02. SITUAÇÃO/REQUISITO

Na release 12.1.25 foi liberada a API ProductionAppointment, porém na documentação padrão não existe um exemplo e sus funcionalidades.

Documentação: https://api.totvs.com.br/apidetails/ProductionAppointment_v2_000.json

03. SOLUÇÃO

Documentar a API ProductionAppointment com exemplo e suas funcionalidades/restrições.

Verbo: POST ({{host}}/api/supply/v2/productionAppointment)

JSON de Envio:

1) JSON para inclusão de um apontamento de produção:

{
"Company": "01",
"User":"admlog",
"AppointmentType":"1",
"ProductionOrderNumber":"123",
"ItemCode":"ITEM-FINAL",
"ApprovedQuantity":"1",
"ScrapQuantity":"0",
"LotCode":"",
"ProductionShiftNumber":"1",
"StartReportDateTime":"2023-06-14T08:00:00",
"EndReportDateTime":"2023-06-14T10:00:00",
"ToolCode": "",
"MachineCode": "",
"OperatorCode":"1"
}

Informações das TAGS do JASON 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
Company	empresa - Código da empresa	CHAR(02)	Sim
User	usuario - Código do usuário	CHAR(08)	Sim
AppointmentType	tipo_apontamento - Tipo do apontamento	CHAR(01)	Não	Tipo = 1 - Apontamento por ordem (No momento está liberado somente o apontamento por ordem) Se não for informado o tipo do apontamento, será considerado como tipo 1 - Por Ordem.
ProductionOrderNumber	ordem_producao - Ordem de produção	INTEGER	Sim
ItemCode	item_produzido - Item produzido	CHAR(15)	Não
ApprovedQuantity	qtd_boas - Quantidade boas	DECIMAL(10,3)	Não
ScrapQuantity	qtd_refugo - Quantidade refugo	DECIMAL(10,3)	Não
LotCode	lote_produzido - Lote produzido	CHAR(15)	Não	Se o item da ordem controlar lote e não for informado o lote, será considerado o número da ordem de produção como o número do lote.
ProductionShiftNumber	turno_producao - Turno produção	DECIMAL(3,0)	Não
StartReportDateTime	data_ini_producao - Data início da produção hor_ini_producao - Hora início da produção	DATETIME	Não
EndReportDateTime	dat_final_producao - Data final da produção hor_final_producao - Hora final da produção	DATETIME	Não
ToolCode	ferramental - Código da ferramenta	CHAR(15)	Não
MachineCode	eqpto - Código do equipamento	CHAR(15)	Não
OperatorCode	operador - Código do operador	CHAR(15)	Não

Considerações:

As seguintes regras estão previstas:

Está liberada somente a opção de apontamento por ordem. Tipo do apontamento = 1.
As regras e validações do apontamento são as mesmas do apontamento padrão - MAN8228
Funcionalidades do padrão não previstas:
- Apontamento por item;
- Apontamento por operação;
- Apontamento de parada;
- Apontamento de sucata;
- Apontamento de defeito;
- Apontamento de retrabalho;
- Apontamento de reforma;
- Observação;
- Alteração dos componentes. A baixa será realizada por backflush;
- Dimensional para o item da ordem;
- Informar conta contábil e seção requisitante;
- Integração com o WMS;
- Estorno

04. DEMAIS INFORMAÇÕES

Não se aplica.

05. ASSUNTOS RELACIONADOS

Não se aplica.

Páginas filhas