Inventory
  1. Docs
Inventory
  • Docs
    • 00. Autenticação
    • 01. Incluir Movimentação Especial
    • 02. Incluir Nota Fiscal de Entrada
    • 03. Cancelar Nota Fiscal de Entrada
    • 04. Gerar Lote de Garantia para Item da Nota Fiscal
    • 05. Incluir Fornecedor
    • 06. Consultar Materiais/Itens
    • 07. Incluir Material/Item
    • 08. Consultar Tipos de Item
    • 09. Incluir Tipo de Item
    • 10. Vincular Tipo de Item a Centro de Estoque
    • 11. Consultar Famílias
    • 12. Incluir Família de Itens
    • 13. Consultar Centros de Estoque
    • 14. Incluir Centro de Estoque
    • 15. Atualizar Centro de Estoque
    • 16. Consultar Centros Financeiros
    • 17. Incluir Centros Financeiros
  • RM
    • Incluir movimentação especial
      POST
    • Incluir nota fiscal de entrada
      POST
    • Cancelar nota fiscal de entrada
      POST
    • Gerar lote de garantia para item da nota fiscal
      POST
    • Incluir fornecedor
      POST
    • Consultar materiais
      GET
    • Incluir material
      POST
    • Consultar tipos de item
      GET
    • Incluir tipo de item
      POST
    • Vincular tipo de item a centro de estoque
      POST
    • Consultar famílias
      GET
    • Incluir família
      POST
    • Consultar centros de estoque
      GET
    • Incluir centro de estoque
      POST
    • Atualizar centro de estoque
      PATCH
    • Consultar centros financeiros
      GET
    • Incluir centros financeiros
      POST
  1. Docs

16. Consultar Centros Financeiros

Os centros financeiros são organizados em uma estrutura em árvore, como na imagem abaixo.
Captura de tela de 2024-10-01 16-47-33.png
Cada centro financeiro de um nível mais profundo tem seu código concatenado com o de seus pais. Por exemplo, o de nome “POA - Bancada de Teste” tem código “ESTQ.2.103”.
É possível buscar a partir de um nó específico passando o parâmetro de query “codigo-cf”. Por exemplo, com o valor “ESTQ”, serão retornados os filhos de ESTQ que são ESTQ.1, ESTQ.2 e ESTQ.41 da imagem.
Pode-se buscar por mais níveis de uma só vez, passando-se o parâmetro de query “depth-limit” que por padrão é 1.

Retorno da requisição#

Um json com o status da requisição: sucesso ou erro. E com os dados dos centros financeiros em uma coleção (array). No caso de erro, é retornada uma mensagem descritiva do erro.
Exemplo 1: Sucesso 200 OK
/centro-financ?codigo-cf=ESTQ&depth-limit=2
Busca a partir de ESTQ com dois níveis de profundidade. Retorno relativo à última imagem de exemplo.
{
    "status": "success",
    "data": {
   	 "centro_financ": [
   		 {
   			 "ID_CENTRO_FINANC": 3465,
   			 "COD_CENTRO_FINANC_PAI": "ESTQ",
   			 "COD_SUB_CENTRO_FINANC": "1",
   			 "COD_CENTRO_FINANC": "ESTQ.1",
   			 "DESC_CENTRO_FINANC": "Novos",
   			 "DESC_TIPO_CENTRO_FINANC": "Centro de Estoque"
   		 },
   		 {
   			 "ID_CENTRO_FINANC": 3466,
   			 "COD_CENTRO_FINANC_PAI": "ESTQ",
   			 "COD_SUB_CENTRO_FINANC": "2",
   			 "COD_CENTRO_FINANC": "ESTQ.2",
   			 "DESC_CENTRO_FINANC": "Usados",
   			 "DESC_TIPO_CENTRO_FINANC": "Centro de Estoque",
   			 "CENTRO_FINANC": [
   				 {
   					 "ID_CENTRO_FINANC": 3478,
   					 "COD_CENTRO_FINANC_PAI": "ESTQ.2",
   					 "COD_SUB_CENTRO_FINANC": "103",
   					 "COD_CENTRO_FINANC": "ESTQ.2.103",
   					 "DESC_CENTRO_FINANC": "POA - Bancada de Teste",
   					 "DESC_TIPO_CENTRO_FINANC": "Centro de Estoque"
   				 }
   			 ]
   		 },
   		 {
   			 "ID_CENTRO_FINANC": 3467,
   			 "COD_CENTRO_FINANC_PAI": "ESTQ",
   			 "COD_SUB_CENTRO_FINANC": "41",
   			 "COD_CENTRO_FINANC": "ESTQ.41",
   			 "DESC_CENTRO_FINANC": "POA - Reciclados",
   			 "DESC_TIPO_CENTRO_FINANC": "Centro de Estoque"
   		 }
   	 ]
    }
}
Exemplo Posman:
Captura de tela de 2024-10-01 16-49-41.png
Previous
15. Atualizar Centro de Estoque
Next
17. Incluir Centros Financeiros