Histórico da Página

Disponibilizado endpoint para integração do cadastro de Centro de Custo Industrial com os métodos GET, POST, PUT, PATCH e DELETE.

...

...

GET (Consulta Centro de Custo Industrial)

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

{
    "hasNext": true,
    "items": [
        {
            "id": 203,
            "codigoEmpresa": 1,
            "codigoCCusto": "1",
            "codigo": "30",
            "descricao": "ALIMENTAÇÃO",
            "descricaoResumida": "ALIMENTAÇÃ",
            "referencia": null,
            "ativo": "0"
        },
        {
            "id": 208,
            "codigoEmpresa": 1,
            "codigoCCusto": "6",
            "codigo": "10",
            "descricao": "ANÁLISE CANA DE AÇÚCAR",
            "descricaoResumida": "ANÁLISE CA",
            "referencia": null,
            "ativo": "1"
        }
    ]
}

Parâmetros

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

...

PUT/PATCH (Modifica Centro de Custo Industrial)

http:127.0.0.1:8080/api/entity/v1/centroCustosIndustriais

...

{
	"id": 348,
    "codigoEmpresa": null, 
    "codigoEmpresaERP": 1,
     "codigo": "API123",
    "descricao": "TESTE TA-API-HUB",
    "descricaoResumida": "TESTE TA-A",
    "referencia": null,
    "ativo": "1"
}

...

• Quando PATCH poderão ser enviados apenas os atributos que necessitam de atualização e os atributos que compõe a chave primária (id ou codigoEmpresa+codigo).
• No caso de PUT deverão ser enviados os atributos necessários/que necessitam de atualização, bem como os atributos obrigatórios e os atributos que compõe a chave primária (id ou codigoEmpresa+codigo).
• Caso o atributo codigoEmpresa não esteja seja informado, será utilizado o valor definido no parâmetro default-company-ind.o codigoEmpresaERP será sempre desconsiderado.
• Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresaO conteúdo do atributo codigoCCusto será sempre desconsiderado e será atribuído o valor do atributo codigo.
• O centro de custo será localizado seguindo a seguinte regra:
  • Caso o atributo id esteja informado, o centro de custo será localizado pelo atributo id e os atributos codigoEmpresa/codigoEmpresaERP e codigo serão ignorados mesmo sendo informados.
  • Caso o atributo id não esteja informado, o centro de custo será localizado pelos atributos codigoEmpresa/codigoEmpresaERP e codigo.
• Os atributos codigoEmpresa , codigoCCustoe codigo não serão alterados mesmo sendo informados.
• Caso o atributo descricao esteja informado e o atributo descricaoResumida não esteja informado, será atribuído o valor do atributo descricao ao atributo descricaoResumida limitado a 10 caracteres.

...

POST (Insere Centro de Custo Industrial)

http:127.0.0.1:8080/api/entity/v1/centroCustosIndustriais

...

{
    "codigo": "api123",
    "codigoCCustodescricao": "XXXTeste ta-API-Hub", 
    "descricaocodigoEmpresaERP": "Teste ta-API-Hub"1
}

Estrutura de dados retorno:

{
    "codigo": "API123",
    "codigoCCusto": "API123",
    "descricao": "TESTE TA-API-HUB",
    "ativo": "1",
    "codigoEmpresa": "1",
    "id": "348",
    "descricaoResumida": "TESTE TA-A"
}

Observações

• Caso o Código da Empresa não for enviadoos atributos codigoEmpresa e codigoEmpresaERP não forem informados, será utilizado como default o valor definido no parâmetro default-company-ind.
• A chave estrangeira composta da Família/Grupo será validada pelo banco de dados apenas se os dois campos forem informados.
• A Família poderá ser informada sem o Grupo porém o Grupo não poderá ser informado sem a Família.
• Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
• Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
• Os atributos codigo e descricao deverão ser informados.
• O conteúdo do atributo id será sempre desconsiderado caso informado e gerado um novo.
• Caso o atributo descricaoResumida não esteja informado, será atribuído o valor do atributo descricao ao atributo descricaoResumida limitado a 10 caracteres.
• Caso já exista um centro de custo para a chave codigoEmpresa/codigoEmpresaERP+codigo informada não será permitida a inclusão e um aviso será mostradoValidação da conta contábil (atributo "contaERP"):
• Caso o parâmetro geral do PIMSMI CON_CTACONTAB for diferente de '1' e o parâmetro "CCONTABIL" da seção "GERAL" também for diferente de '1' não será acatada a conta contábil informada sendo zerado o atributo antes da gravação.
Caso o parâmetro "C.CONTABIL" da seção "OS_MATPREVISTO" for diferente de '1' o código da conta contábil informada será validada na tabela do bioenergia através de um sinônimo entre os owners e caso a conta for inválida será mostrada uma mensagem ao usuário e abortada a gravação.

DELETE (Exclui Centro de Custo Industrial)

...

Método DELETE:

http:127.0.0.1:8080/api/entity/v1/centroCustosIndustriais

Parâmetros

• Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
• Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
• Deverão ser informados os atributos que compõe a chave primária (id ou codigoEmpresa/codigoEmpresaERP+codigo).
• O centro de custo será localizado seguindo a seguinte regra:
  • Caso o atributo id esteja informado, o centro de custo será localizado pelo atributo id e os atributos codigoEmpresa/codigoEmpresaERP e codigo serão ignorados mesmo sendo informados.
  • Caso o atributo id não esteja informado, o centro de custo será localizado pelos atributos codigoEmpresa/codigoEmpresaERP e codigo
  Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET
  • .