Sincronizar Contatos
contato/save
|
|
|---|---|
DESCRIÇÃO | Este método tem a função de atualizar e/ou registrar contatos novos, de acordo com os dados informado nos campos. NOTA: Para cadastrar um contato novo, não informe o "id_contato", para atualizar o contato, basta recuperar a informação da listagem e informar no campo "id_contato" |
ESTRUTURA DA URL | |
VERSÃO | 1 |
MÉTODO | POST |
PARÂMETROS | format opcional Opção de retorno da API, podendo ser JSON ou XML (se não informado, JSON será o padrão) access_token obrigatório Chave de acesso ao método. Para saber como obter, clique aqui id_contato opcional Se não for informado sera incluído um novo registro. Se for informado vai localizar o cadastro e atualizar id_grupo obrigatório Código do grupo de contatos onde será atualizado e ou cadastrado razao_social obrigatório Nome razão social da empresa contato obrigatório Nome do Contato telefone_fixo obrigatório Numero de telefone fixo do contato celular obrigatório Numero de telefone celular email opcional Endereço de e-mail do contato pais opcional Nome do país cep opcional Número do cep de endereço rua opcional Logradouro do endereço numero opcional Numero do endereço bairro opcional Nome do Bairro do endereço complemento opcional Informações adicionais ao endereço do contato cidade opcional Nome da Cidade de endereço do contato estado opcional Abreviação do nome do Estado (XX) ramo_atividade opcional Área em que atua no mercado observacao opcional Dados adicionais oauth_id_responsavel opcional código do usuário de acesso da API |
RETORNO | api Nome da API que esta sendo usada modulo Módulo que está sendo chamado status Mensagem de status codigo Código de retorno - Clique aqui para listar os códigos e suas descrições data Array de resposta da API
Exemplo de respostas em JSON
{
"api": "contato",
"modulo": "contato",
"status": "ok",
"codigo": "000",
"msg": "Contato atualizado com sucesso",
"data": {
"id_contato": "XXXXXXX",
"id_empresa": "XXXX",
"id_usuario": "XXXX",
"id_grupo": "XXXXX",
"razao_social": "NOME EMPRESA LTDA",
"contato": "CONTATO",
"telefone_fixo": "5541XXXXXXXX",
"celular": "5541XXXXXXXXX",
"email": "",
"pais": "",
"cep": "",
"rua": "",
"numero": "0",
"bairro": "",
"complemento": "",
"cidade": "",
"estado": "",
"ramo_atividade": "",
"observacao": "",
"criado_em": "2000-01-01 00:00:00",
"excluido_em": null
}
}
Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisição de novos tokens. |