Integração com Maxxsoft - MaxxSFA+

Focado em revendas agrícolas e cooperativas, o MaxxSFA+ da Maxxsoft é um serviço de força de vendas voltado para a realização de prospecção, vendas e acompanhamento em campo. É majoritariamente utilizado por representantes comerciais e técnicos, tendo como principais módulos e suas funcionalidades: clientes, produtos, pedidos, agenda, despesas, visita técnica, fechamento de safra, pnp (planejamento do produtor) e oportunidades.

Esta parceria Maxxsoft com o Gestão de Relacionamento | CRM oferece integração dos módulos clientes, produtos, agenda e oportunidades, que proporciona assim uma maior atenção aos seus clientes, facilitando prospecções e gerando novas possibilidades de negócios. Os demais módulos e funcionalidades - despesas, registro de visitas, pnp e fechamento de safra - podem ser gerenciados através do menu do APP MaxxSFA+.

Conheça mais sobre o nosso parceiro de sucesso MaxxSFA+.

APIs de Integração

O Gestão de Relacionamento | CRM disponibiliza web services do tipo REST, que permitem a integração da MaxxSFA+ com o sistema.

Veja abaixo a documentação das APIs disponíveis:

Agenda

Tabela	Campos	Obrigatório
Agenda	Atividade	S
	Prioridade	S
	Categoria	S
	Data inicial	N
	Hora inicial	N
	Data final	N
	Hora final	N
	Cliente	N
	Propriedade	N
	Contato	N
	Assunto	S
	Observações	N

GET

GET {{CURRENT_HOST}}/appointment?filtros={“usuarioAgendador.id”:{“eq”:“3”}}

De (CRM)	Para (MaxxSoft)
id	sync
contato	contato
assunto	assunto
data_inicio	dtIniAgen-damento
data_fim	dtFimAgen-damento
id	prioridade
id	categoria
id	colaborador
id	conta
id	propriedade
cep	ende-reco.cep
latitude	ende-reco.latitude
longitude	ende-reco.longitude
endereco	ende-reco.endereco
numero	ende-reco.numero
complemento	ende-reco.complemento
id	status
data_inicial	dtIniAgen-damento

GET {{CURRENT_HOST}}/appointment-geolocation

De (CRM)	Para (MaxxSoft)
complemento	ende-reco.complemento
bairro	ende-reco.bairro
cep	ende-reco.cep
latitude	ende-reco.latitude
longitude	ende-reco.longitude

GET {{CURRENT_HOST}}/backend/public/appointment-categories

De (CRM)	Para (MaxxSoft)
id 1	sync
nome	descricao
id 2	sync
nome	descricao
id 3	sync
nome	descricao
id 4	sync
nome	descricao
id 5	sync
nome	descricao
id	sync
nome	descricao
id	sync
nome	descricao

Cliente

Tabela	Campos	Obrigatório
Cliente	Tipo de pessoa	S
	CPF	N
	Razão	S
	Fantasia	S
	Tipo	S
	Rating	S
	Porte	S
	Ramo	S
	Origem	S
	Receita anual	N
	Sexo	N
	INS Estadual	N
	Produtor rural	N
	E-mail	N
	Data cadastro	N
	Limite de crédito	N

GET

GET {{CURRENT_HOST}}/backend/public/account-types

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

GET {{CURRENT_HOST}}/backend/public/company-size

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

GET {{CURRENT_HOST}}/backend/public/activity-branches

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

GET {{CURRENT_HOST}}/backend/public/account-origins?filtros={“conta”:{“in”:[8234]}}

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

GET {{CURRENT_HOST}}/backend/public/account-origins

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

GET {{CURRENT_HOST}}/backend/public/account-definitions

De (CRM)	Para (MaxxSoft)
bairro	endereco.bairro
cep	endereco.cep
bairro	endereco.bairro
cep	endereco.cep

POST

POST {{CURRENT_HOST}}/backend/public/account

De (MaxxSoft)	Para (CRM)
razão	nome
fantasia	fantasia
tipo	tipo_pessoa
rating	rating
cpfCnpj	cpf
inscEstadual	inscricao_estadual
email	email_geral
dtCadastro	data_cadastro
origemConta	origem
porteConta	porte_empresa
ramoAtividade	ramp_atividade
receitaAnual	receita_anual

Cliente/Endereço

Tabela	Campos	Obrigatório
Cliente/Endereço	Principal	N
	Tipo	S
	País	S
	Município	S
	CEP	S
	Endereço	S
	Número	N
	Complemento	N
	Bairro	S
	Latitude	N
	Longitude	N

GET

GET {{CURRENT_HOST}}crmx.crmsenior.com.br/backend/public/account-addresses/$id

De (CRM)	Para (MaxxSoft)
cep	endereco.cep
bairro	endereco.bairro
endereço	endereco.endereco
complemento	ende-reco.complemento
latitude	endereco.latitude
longitude	endereco.longitude
cidade	endereco.municipio
estado	endereco.estado
cad_cidades	endereco.municipio

POST

POST {{CURRENT_HOST}}/backend/public/account-addresses

De (MaxxSoft)	Para (CRM)
endereco.descricao	endereço
endereco.tipo	tipo_endereco
endereco.numero	numero
ende-reco.complemento	complemento
endereco.bairro	bairro
endereco.cep	cep
endereco.latitude	latitude
endereco.longitude	longitude
endereco.municipio	cidade
endereco.principal	principal

Cliente/Telefone

Tabela	Campos	Obrigatório
Cliente/Telefone	Principal	N
	Tipo	S
	Número	S

De (MaxxSoft)	Para (CRM)
numero	numero
tipo	tipo_telefone
operadora	operadora
principal	principal

Cliente/Propriedade

Tabela	Campos	Obrigatório
Cliente/Propriedade	Propriedade	S
	Gerente	N
	Telefone	N
	País	S
	Município	S
	CEP	S
	Endereço	S
	Bairro	S
	Localização	N
	Latitude	N
	Longitude	N
	INS Estadual	N
	Área	N

GET

GET {{CURRENT_HOST}}/backend/public/property?filtros={“ConContas.id”:{“eq”:[$id]}}

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome
area_cultivo	areaCultivo
area_total	area
cep	endereco.cep
latitude	endereco.latitude
longitude	endereco.longitude
endereco	descricao
numero	numero
complemento	endereco.complemento
bairro_vilarejo	bairro
inscricao_estadual	inscEstadual
id	conta
id	municipio
bairro	endereco.bairro
cep	endereco.cep
endereco	endereco.endereco
bairro	endereco.bairro
cep	endereco.cep

Produtos

Tabela	Campos	Obrigatório
Produtos	Código	S
	Descrição	N
	Unidade	N

Oportunidades

Tabela	Campos	Obrigatório
Oportunidades	Data	S
	Horário	S
	Descrição	N
	Cliente	S
	Tipo	S
	Origem	S
	Modalidade de negócio	S
	Etapa da negociação	S
	Dados da negociação	N
	Observações	N

GET

GET {{CURRENT_HOST}}opportunities

De (CRM)	Para (MaxxSoft)
id	sync
data	timestamp
nome_oportunidade	nome
conta_id	conta
empresa_id	empresa
tipo_oportunidade_id	tipo
origem_oportunidade_id	origem
usuario_id	colaborador
estagio	etapa
probabilidade	probabilidade
numero_proposta	numeroProposta
data_prevista_fechamento	dtPrevistaFechamento
data_efetiva_fechamento	dtEfetivaFechamento
data_prevista_entrega	dtPrevistaEntrega
data_efetiva_entrega	dtEfetivaEntrega
valor_previsto	valorPrevisto
valor_fechado	valorFechado
valor_previsto_moeda	valorPrevistoMoeda
valor_fechado_moeda	valorFechadoMoeda
quantitativo_previsto	quantitativoPrevisto

GET {{CURRENT_HOST}}/backend/public/opportunity-origins

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome
empresa	empresa

GET {{CURRENT_HOST}}/backend/public/business-types

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome
observacao	observacao
empresa	empresa

POST

POST {{CURRENT_HOST}}/backend/public/opportunities

De (MaxxSoft)	Para (CRM)
estagio	etapa
origem_oportunidade_id	origem
tipo_oportunidade_id	tipo
conta_id	conta
usuario_id	colaborador
data	timestamp
nome_oportunidade	nome
probabilidade	probabilidade
valor_previsto	valorPrevisto
valor_previsto_moeda	valorPrevistoMoeda
valor_fechado	valorFechado
valor_fechado_moeda	valorFechadoMoeda
numero_proposta	numeroProposta

Oportunidades/Ações

Tabela	Campos	Obrigatório
Oportunidades/Ações	Tipo da ação	S
	Probabilidade	S
	Previsão de fechamento	N
	Efetivação de fechamento	N
	Previsão de entrega	N
	Efetivação de entrega	N
	Valor previsto	N
	Valor fechado	N
	Valor previsto USD	N
	Valor fechado USD	N
	Observações	S

GET

GET {{CURRENT_HOST}}/v2/opportunities-actions

De (CRM)	Para (MaxxSoft)
id	sync
oportunidade_id	oportunidade
tipo_acao_id	tipoAcao
data	data
muda_oportunidade	mudaOportunidade
probabilidade	probabilidade
data_prevista_fechamento	previsaoFechamento
data_efetiva_fechamento	efetivacaoFechamento
data_prevista_entrega	previsaoEntrega
data_efetiva_entrega	efetivacaoEntrega
valor_previsto	valorPrevisto
valor_fechado	valorFechado
valor_previsto_moeda	valorPrevistoMoeda
valor_fechado_moeda	valorFechadoMoeda
observacoes	observacao

GET {{CURRENT_HOST}}/backend/public/action-types

De (CRM)	Para (MaxxSoft)
id	sync
nome	nome

POST

POST {{CURRENT_HOST}}/v2/opportunities-actions

De (MaxxSoft)	Para (CRM)
id	sync
probabilidade	probabilidade
observacoes	observacao
oportunidade_id	oportunidade
tipo_acao_id	tipoAcao
data	data
muda_oportunidade	mudaOportunidade
numero_proposta	numeroProposta
data_prevista_fechamento	privisaoFechamento
data_efetiva_fechamento	efetivacaoFechamento
data_prevista_entrega	previsaoEntrega
data_efetiva_entrega	efetivacaoEntrega
valor_previsto	valorPrevisto
valor_fechado	valorFechado
valor_previsto_moeda	valorPrevistoMoeda
valor_fechado_moeda	valorFechadoMoeda

Oportunidades/Propostas

Tabela	Campos	Obrigatório
Oportunidades/Propostas	Data	S
	Horário	S
	Descrição	N
	Prazo pagamento	S
	Nome do destinatário	N
	E-mail do destinatário	N
	Telefone do destinatário	N

GET

GET {{CURRENT_HOST}}/backend/public/opportunities-proposal

De (CRM)	Para (MaxxSoft)
id 1	sync
data	timestamp
numero_proposta	numeroProposta
data_envio	dtEnvio
prazo_pagamento_id	prazoPagamento

Oportunidades/Proposta/Produtos

Tabela	Campos	Obrigatório
Oportunidades/Proposta/Produtos	Quantidade	N
	Preço	N
	Descrição	N
	Produto	S

De (CRM)	Para (MaxxSoft)
id	sync
categoria_produto_id	grupoProduto
empresa_id	empresa
nome	descricao

De (CRM)	Para (MaxxSoft)
id 35	sync
quantidade	quantidade
valor_venda	valor
id 2	produto