Criar um registro

Os registros no Cange são fundamentais para armazenar dados essenciais dos seus clientes, fornecedores, produtos, entre outros, possibilitando um gerenciamento detalhado e organizado. Com a flexibilidade para criar campos customizados, você pode garantir que a informação armazenada atenda precisamente às necessidades específicas do seu negócio.

Utilizar a API do Cange para criar registros oferece uma maneira altamente eficiente e automatizada de inserir, atualizar e gerir esses dados diretamente a partir das suas aplicações ou sistemas. Isso não só simplifica o processo, mas também melhora a produtividade e garante a integridade dos processos, assegurando que todos os dados cruciais sejam geridos de forma integrada e precisa.

Para criar um registro através da API, você precisará ter um token de acesso. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

Autenticação

Como os cadastros no Cange possuem campos dinâmicos, simplificamos o processo para você. Na tela de configuração dos campos, oferecemos uma opção prática para copiar o objeto do body da requisição completa. Basta abrir a tela de edição dos campos e, abaixo da pré-visualização do formulário, você encontrará um contêiner com a informação "Objeto API". Copie esse objeto e use-o como base para montar sua solicitação de criação de um registro, garantindo que todos os campos dinâmicos sejam corretamente incluídos.

Realizando a chamada para criação do cartão

POST /form/new-answer

Endpoint com o objetivo de criar um novo cartão dentro de um fluxo

Headers

Name	Value
Content-Type	application/json
Origin	https://app.cange.me
Authorization	Bearer <token de acesso>

Body

Name	Type	Description
id_form	number	Código identificador do formulário
origin	string	Identificação do local que está partindo a solicitação
values	object	Objeto com os campos do formulário e seu valor para inserção (Este objeto pode ser copiado na tela do formulário)
register_id	number	Código identificador do cadastro

{
  "id_form": 3092,
  "origin": "/NomeDaSuaApi",
  "values": {
    "a4adaca0011489add4c4397ffdf8a434d7af59ee": "ReplaceByYourValue",
  },
  "register_id": 196
}

Response

200

[
   {
      "form_id":3092,
      "user_id_creator":230,
      "dt_created":"2024-09-06T14:46:16.000Z",
      "company_id":215,
      "origin":"/NomeDaSuaApi",
      "register_id":196,
      "id_form_answer":379412,
      "dt_deleted":null,
      "form_answer_fields":[
         {
            "form_answer_id":379412,
            "field_id":8153,
            "index":0,
            "value":"ReplaceByYourValue",
            "dt_created":"2024-09-06T14:46:16.000Z",
            "dt_last_update":"2024-09-06T14:46:16.000Z",
            "id_form_answer_field":2403205,
            "dt_deleted":null
         }
      ]
   }
]