Integração E-commerce Bluesoft ERP

APIs Integração E-commerce

Incluir Novo Cliente:
https://erp.bluesoft.com.br/{tenant}/api/clientes

Nome	Tipo	Tamanho	Obrigatório	Descrição
atualizaPessoa	boolean
bairro	string	[ 2 .. 60 ] characters	–	Utilizar a lista de endereço no atributo endereços
cep	string	8 characters	–	Utilizar a lista de endereço no atributo endereços
cidade	string	[ 1 .. 40 ] characters	–	Utilizar a lista de endereço no atributo endereços
complemento	string	[ 1 .. 60 ] characters	–	Utilizar a lista de endereço no atributo endereços
conjuge	string	[ 3 .. 100 ] characters	–
contatos	Array ()			Array of objects (ContatoForm) unique
TipoContato	string		Sim	StringEnum: “EMAIL_ECOMMERCE” “EMAIL_NOTA_FISCAL_ELETRONICA” “TELEFONE_ECOMMERCE”
valor	string	[ 1 .. 100 ] characters	Sim
cpfCnpj	string	[ 11 .. 14 ] characters	Sim
enderecos	Array ()			Array of objects (EnderecoFormReq)
bairro	string	[ 2 .. 60 ] characters	Sim
cep	string	8 characters	Sim
cidade	string	[ 1 .. 40 ] characters	Sim
numero	string	[ 1 .. 10 ] characters	Sim
complemento	string	[ 1 .. 60 ] characters	–
rua	string	[ 3 .. 60 ] characters	Sim
tipoDeEndereco	string		Sim	stringEnum: “ADICIONAL” “COBRANCA” “ECOMMERCE” “ENTREGA” “FATURAMENTO”
uf	string		Sim	stringEnum: “AC” “AL” “AM” “AP” “BA” “CE” “DF” “ES” “EX” “GO” “MA” “MG” “MS” “MT” “PA” “PB” “PE” “PI” “PR” “RJ” “RN” “RO” “RR” “RS” “SC” “SE” “SP” “TO”
estadoCivil	string		Sim	stringEnum: “CASADO” “DIVORCIADO” “SEPARADO” “SOLTEIRO” “VIUVO”
nomeRazao	string	[ 3 .. 100 ] characters	Sim
sexo	string		Sim	Enum: “F” “M”

application/json

Incluir Pedido de Venda do Tipo E-commerce

https://erp.bluesoft.com.br/{tenant}/api/venda/pedidovenda/e-commerce

Nome	Tipo	Tamanho	Obrigatório	Descrição
atualizaPessoa	boolean
bairro	string	[ 2 .. 60 ] characters	–	Utilizar a lista de endereço no atributo endereços
cep	string	8 characters	–	Utilizar a lista de endereço no atributo endereços
cidade	string	[ 1 .. 40 ] characters	–	Utilizar a lista de endereço no atributo endereços
complemento	string	[ 1 .. 60 ] characters	–	Utilizar a lista de endereço no atributo endereços
conjuge	string	[ 3 .. 100 ] characters	–
contatos	Array ()			Array of objects (ContatoForm) unique
TipoContato	string		Sim	StringEnum: “EMAIL_ECOMMERCE” “EMAIL_NOTA_FISCAL_ELETRONICA” “TELEFONE_ECOMMERCE”
valor	string	[ 1 .. 100 ] characters	Sim
cpfCnpj	string	[ 11 .. 14 ] characters	Sim
enderecos	Array ()			Array of objects (EnderecoFormReq)
bairro	string	[ 2 .. 60 ] characters	Sim
cep	string	8 characters	Sim
cidade	string	[ 1 .. 40 ] characters	Sim
numero	string	[ 1 .. 10 ] characters	Sim
complemento	string	[ 1 .. 60 ] characters	–
rua	string	[ 3 .. 60 ] characters	Sim
tipoDeEndereco	string		Sim	stringEnum: “ADICIONAL” “COBRANCA” “ECOMMERCE” “ENTREGA” “FATURAMENTO”
uf	string		Sim	stringEnum: “AC” “AL” “AM” “AP” “BA” “CE” “DF” “ES” “EX” “GO” “MA” “MG” “MS” “MT” “PA” “PB” “PE” “PI” “PR” “RJ” “RN” “RO” “RR” “RS” “SC” “SE” “SP” “TO”
estadoCivil	string		Sim	stringEnum: “CASADO” “DIVORCIADO” “SEPARADO” “SOLTEIRO” “VIUVO”
nomeRazao	string	[ 3 .. 100 ] characters	Sim
sexo	string		Sim	Enum: “F” “M”
aguardandoPagamento	boolean
canalVendaKey	integer <int64>		–
cliente			Sim	object (PedidoVendaEcommerceIncluirClienteRequest)
cpfCnpj	integer <int64>		Sim
dataNascimento	string	<date-time> Formato ‘dd/MM/yyyy’	–
email	string		–
enderecoCobranca			–	object (PedidoVendaEcommerceIncluirEnderecoRequest)
enderecoEntrega			–	object (PedidoVendaEcommerceIncluirEnderecoRequest)
fidelidade	boolean		–
inscricaoEstadual	string		–
nome	string	[ 0 .. 100 ] characters	–
nomeFantasia	string	[ 0 .. 100 ] characters	–
razaoSocial	string		–
rg	string		–
telefones	Array of strings unique		–
cnpjLoja	integer <int64> <= 99999999999999		–
dadosDeEntrega			–	object (PedidoVendaEcommerceIncluirDadosDeEntregaRequest)
codigoTransportadora	string		–
formaDeEnvio	string		–
numero	string		–
valorFrete	number <double>		–
dataAgendamentoRetirada	string	Formato ‘dd/MM/yyyy HH:mm’	–
dataAgendamentoRetiradaFinal	string	Formato ‘dd/MM/yyyy HH:mm’	–
dataDeEmissao	string	Formato ‘dd/MM/yyyy HH:mm’	–
dataPrevisaoEntrega	string	Formato ‘dd/MM/yyyy HH:mm’	–
dataPrevisaoEntregaFinal	string	Formato ‘dd/MM/yyyy HH:mm’	–
ecommerceKey	integer <int32>		Sim
itens				Array of objects (PedidoVendaEcommerceIncluirItemPedidoRequest) unique
desconto	number <double>		–
observacao	string		–
precoDeVenda	number <double>		Sim
produtoKey	integer <int32>		Sim
quantidade	number <double>		Sim
quantidadeSeparada	number <double>		–
lojaKey	integer <int32> [ 1 .. 999999999 ]		–
numeroPedido	string	[ 0 .. 50 ] characters	–
observacao	string		–
pagamentos				Array of objects (PedidoVendaEcommerceIncluirPagamentoRequest)
autorizadora	string			Enum: “BRASPAG” “CIELO” “DMCARD” “MAGAZINE_LUIZA” “MERCADO_PAGO” “MUNDIPAGG” “PAGAR_ME” “REDE”
bandeira	string		–
codigoAutorizacao	string		–
formaDePagamento	string			Enum: “BOLETO_BANCARIO” “CARTAO_DE_CREDITO” “CARTAO_DE_DEBITO” “CHEQUE” “DEPOSITO_BANCARIO” “DINHEIRO” “PAGAMENTO_INSTANTEO_PIX” “PROGRAMA_FIDELIDADE_CASHBACK_CREDITO_VIRTUAL” “SEM_PAGAMENTO” “TRANSFERENCIA_BANCARIA_CARTEIRA_DIGITAL” “VALE_ALIMENTACAO” “VALE_PRESENTE”
idEcommerce	integer <int32>		–
nsu	string		–
parcelas	integer <int32>		–
tipoIntegracaoPagamento	string			Enum: “PAGAMENTO_INTEGRADO” “PAGAMENTO_NAO_INTEGRADO”
tipoPagamentoEcommerce	string			Enum: “GATEWAY” “PAGAMENTO_NA_ENTREGA” “PAGAMENTO_NA_RETIRADA” “PIX” “TELEVENDAS”
valor	number <double>		–
pedidoSeparado	boolean		–
peso	number		–
prazoPagamentoKey	integer <int64>		–
recebimento	string			Enum: “BOLETO” “CONTRA_VALE” “CONVENIO” “CORNERSHOP” “DESCONTO_FINANCEIRO” “DESCONTO_FINANCEIRO_FORMA_DE_PAGAMENTO” “DEVOLUCAO_TROCA” “DINHEIRO” “EMISSAO_CONTRA_VALE” “ITI” “MERCADO_PAGO” “PAGAMENTO_ONLINE” “PAG_BANK” “PIC_PAY” “PIX” “POS_CREDITO” “POS_DEBITO” “TEF_CARTAO_DEBITO_SAQUE_FACIL” “TEF_CREDITO” “TEF_CREDITO_PARCELADO” “TEF_CREDITO_PRE” “TEF_DEBITO” “TEF_DEBITO_PARCELADO” “TEF_DEBITO_PRE” “VALE_ASSIDUIDADE” “VALE_COMPRA_CLIENTES” “VALE_COMPRA_FUNCIONARIOS” Recebimento. Necessário apenas se gerenciamento pelo módulo de pedido balcão estiver habilitado.
tabelaFreteKey	integer <int64> [ 1 .. 999999999 ]			Tabela de Frete
tipoDeEntrega	string			Informar RETIRA_NA_LOJA ou ENTREGA_NO_CEP
tipoFormaPagamentoKey	integer <int32>			Tipo forma de pagamento. Necessário apenas se gerenciamento pelo módulo do força de vendas estiver habilitado.
tipoIntegracaoPagamento	string			Enum: “PAGAMENTO_INTEGRADO” “PAGAMENTO_NAO_INTEGRADO”
valorFrete	number		–
volume	number		–

application/json