TOTVS AGRO

Páginas filhas
  • API Centro de Custo (Manutenção Industrial)

Versões comparadas

Versão antiga 3

changes.mady.by.user Raul Goulart Rodrigues

Gravado em

comparado com

Nova versão 4

changes.mady.by.user Raul Goulart Rodrigues

Gravado em

Chave

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

...

Atributos

Descrição

Tamanho

Tipo

Chave Primária

Requerido

Valor Default

Valores Válidos

Observação

id

Id único para rastreamento do registro de ponta a ponta

12

NUMBER

S

N

-

-

Gerado automaticamente quando o registro é inserido na tabela

codigoEmpresa

Código da empresa

2

NUMBER

N

N

-

-

-

codigoCCusto

Código do centro de custo

20

STRING

N

N

-

-

-

codigo

Código do subcentro de custo

20

STRING

N

N

-

-

-

descricao

Descrição do centro/subcentro de custo

40

STRING

N

N

-

-

-

descricaoResumida

Descrição resumida do centro/subcentro de custo

10

STRING

N

N

-

-

-

referencia

Referência do subcentro de custo

20

STRING

N

N

-

-

-

ativo

Situação do subcentro de custo

1

STRING

N

N

"1"

0 = Inativo

1 = Ativo

-


GET (Consulta Centros Centro de Custos IndustriaisCusto Industrial)

http:127.0.0.1:8080/queryentity/v1/centroCustosIndustriais?page=1&pagesize=2

...

  • page: Número da página.
  • pagesize: Quantidade máxima de registros por página.

...

  • O usuário deverá disponibilizar a solicitação para o ERP.
  • Serão disponibilizados registros de solicitação cujo status de integração seja igual a "ER" (Erro) ou nulo.


PUT (Atualiza o status da Solicitação de Material/ServiçoPUT/PATCH (Modifica Centro de Custo Industrial)

http:127.0.0.1:8080/queryentity/v1/solicitacaoMaterialServicoIndustrialMativcentroCustosIndustriais

Estrutura de dados para envio:

...

  • Esse método deverá ser chamado para cada registro capturado no método GET, sinalizando que o mesmo foi recebido pelo ERP, só então o registro deixará de ser enviado no método GET.
  • Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
  • Caso não seja informado o atributo statusERP, será atribuído "NP" (Não Processado pelo ERP)como valor default.
  • Quando o atributo statusERP informado for igual a "ER" indicando um erro, além da atualização dos demais campos informados, a solicitação será liberada para que o usuário efetue a devida correção e disponibilize esse registro novamente para o ERP, somente então o registro será enviado novamente no método GET.
  • Os atributos mensagemIntegracao, numeroSolicitacaoCompra, numeroPedidoCompra, dataPrevistaEntrega e comprador são de envio opcional.


POST (Atendimento da Solicitação de Material/ServiçoInsere Centro de Custo Industrial)

http:127.0.0.1:8080/queryentity/v1/solicitacaoMaterialServicoIndustrialMativcentroCustosIndustriais

Estrutura de dados para envio:

...

  • Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
  • O atributo statusERP deverá ser informado.
  • O material será localizado seguindo a seguinte regra:
    • Caso não seja informado um dos atributos codigoMaterial ou codigoMaterialERP, o material será recuperado da solicitação referente ao id enviado.
    • Caso o atributo codigoMaterial esteja informado, o material será localizado pelo atributo codigoMaterial e o atributo codigoMaterialERP será ignorado mesmo sendo informado.
    • Caso o atributo codigoMaterialERP esteja informado, o material será localizado pelo atributo codigoMaterialERP somente se o atributo codigoMaterial não estiver informado.
  • O atributo descricaoMaterial é opcional. Caso informado, será acatado e gravado na tabela de atendimento com a descrição enviada e caso nulo manterá a descrição do material recuperada da solicitação.
  • O atributo unidadeMedida é opcional. Caso informado, será acatado e gravado na tabela de atendimento com a unidade de medida enviada e caso nulo manterá a unidade de medida recuperada da solicitação.
  • O atributo dataAtendimento deverá ser informado.
  • O atributo quantidadeAtendida deverá ser informado.
  • O atributo valorUnitario deverá ser informado.
  • Os atributos numeroDocumentoERP e sequenciaDocumentoERP são de envio opcional.
  • Após a inserção do registro de atendimento, o status de integração da solicitação correspondente será atualizado para o mesmo valor do atributo statusERP informado no atendimento.


DELETE (Exclui Centro de Custo Industrial)

Disponibilizado endpoint para excluir o Centro de Custo.

Método DELETE:

http:127.0.0.1:8080/entity/v1/centroCustosIndustriais

Parâmetros

  • Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.