Bling

objetivo/resumo bling é uma plataforma de gestão empresarial desenvolvida para ajudar pequenas e médias empresas a gerenciar suas operações de forma integrada ele oferece uma variedade de recursos e ferramentas para auxiliar na organização e automação de processos, como controle de estoque, vendas, finanças, compras, emissão de notas fiscais, gestão de clientes, entre outros este conector facilitará integrações com outras plataformas de e commerce e marketplace criando um fluxo utilizando o conector bling para criar um fluxo utilizando o conector bling é preciso criar uma conexão e em seguida configurar o fluxo criando conexão bling obs criar conexão docid 1pcvn0mjbfkujhmhj86k e acesse nosso passo a passo para saber como criar uma conexão estes são os seguintes parâmetros de configuração da conexão bling que serão requisitados na criação nome parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório); descrição parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão; api key informe a chave da api disponibilizada pelo sistema bling (a api key será gerada ao cadastrar um usuário api na bling clique aqui e veja como gerar uma api key) configurando fluxo bling crie um fluxo e arraste o conector bling para o canvas obs criar fluxo docid\ ocjtbfhi9rerkr2d6owip e acesse nosso passo a passo para saber como criar um fluxo selecione o conector e na aba de parametrização preencha os seguintes parâmetros de configuração recurso entidade para qual será realizada a ação no momento o conector dispões dois recursos sendo eles, pedidos e nota fiscal; operação ação que será realizada para o recurso selecionado operações disponiveis para recurso pedidos consultar requer o número do pedido; inserir requer o xml da requisição, podendo ser enviado utilizando de/para docid\ voqdaukjjknbswvrhbzqw ou template docid\ treajh8tvdyh6ukyeaqzp ; atualizar situação requer o número do pedido e o xml da requisição, podendo ser enviado utilizando de/para docid\ voqdaukjjknbswvrhbzqw ou template docid\ treajh8tvdyh6ukyeaqzp ; listar não requer nenhuma informação, retornará todos os pedidos da base bling; operações disponiveis para recurso nota fiscal consultar requer número da nota fiscal e número de série; inserir requer o corpo da requisição com o objeto da nota que deseja inserir, podendo ser utilizado o de/para docid\ voqdaukjjknbswvrhbzqw ou template docid\ treajh8tvdyh6ukyeaqzp para referenciar o corpo; na aba propriedades selecione a conexão desejada, dê um nome ao passo e se necessário detalhe uma descrição configurando callback/webhook na bling para utilizar o gateway fluid docid\ tldeo0voi8xwt2iqj7oiv na configuração de callback na bling , use o query parameter trim prefix para tratar o corpo da requisição disparada pelo erp para mais informações, consulte a documentação referente na prática neste tópico criaremos um exemplo de um fluxo utilizando o conector da bling o fluxo terá apenas um passo que será responsável pelo envio de um pedido para o sistema bling enviaremos um payload de entrada, que passará por uma transformação em nosso de/para docid\ voqdaukjjknbswvrhbzqw , onde será validado algumas rules docid\ lgqsmyrxokym9hgjtotkl , e por fim montaremos o xml necessário para inserir o pedido na bling usando um template docid\ treajh8tvdyh6ukyeaqzp passo 'envia pedido' este primeiro e unico passo irá inserir o pedido no sitema bling somente se todas as rules docid\ lgqsmyrxokym9hgjtotkl mandatórias forem atendidas assim ficará a parametrização do envia pedido para tratar os dados recebidos do payload de entrada usamos o de/para docid\ voqdaukjjknbswvrhbzqw e por fim utilizamos o template para montar o xml da requisição que a operação espera assim ficou nosso de/para para mais informações sobre como tratamos de/paras clique em de/para docid\ voqdaukjjknbswvrhbzqw se observar, alguns valores do nosso de/para estão sendo referenciado algumas rules, essas são rules internas, para mais informações acesse nossa documentação sobre rules docid\ lgqsmyrxokym9hgjtotkl assim ficou nossas rules \[ { "idrule" "clientenome", "rule" "{\\"cat\\" \[ {\\"var\\" \\"customer firstname\\"}, \\" \\", {\\"var\\" \\"customer lastname\\"} ]}", "type" "internal", "description" "concatena o primeiro e último nome do cliente " }, { "idrule" "1", "rule" "{ \\"if\\" \[{\\"==\\" \[ { \\"var\\" \\"status name\\" }, \\"status paid\\" ] }] }", "type" "mandatory" }, { "idrule" "verificatipopessoa", "rule" "{\\"if\\" \[{\\"missing\\" \[\\"customer companyname\\"]},\\"f\\", \\"j\\"]}", "type" "internal" }, { "idrule" "formapagamento", "rule" "{\\"if\\" \[{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method ailospag\\"]}]},\\"2849028\\", {\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method boleto\\"]}]},\\"2849032\\", {\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method pix\\"]}]},\\"2849027\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method deposit\\"]}]},\\"2849031\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard mastercard\\"]}]},\\"2849055\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"'payment method creditcard visa\\"]}]},\\"2849058\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"'payment method creditcard americanexpress\\"]}]},\\"2849054\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"'payment method creditcard aura'\\"]}]},\\"2849043\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"'payment method creditcard bnds'\\"]}]},\\"2849033\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"'payment method creditcard dinners'\\"]}]},\\"2849048\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard discover\\"]}]},\\"2849044\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard elo\\"]}]},\\"2849049\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard hipercard\\"]}]},\\"2849041\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard jcb\\"]}]},\\"2849045\\",{\\"some\\" \[{\\"var\\" \\"paymentmethods\\"},{\\"==\\" \[{\\"var\\" \\" name\\"},\\"payment method creditcard oipaggo\\"]}]},\\"2849036\\"]}", "type" "internal" }, { "idrule" "fluid", "rule" "{ \\"if\\" \[{\\"==\\" \[ { \\"var\\" \\"shoppingstore referencecode\\" }, \\"fluid\\" ] }] }", "type" "mandatory" }, { "idrule" "desconto", "rule" "{ \\" \\" \[{ \\"var\\" \\"promotiondiscount\\" }, { \\"var\\" \\"shippingdiscount\\" } ] }", "type" "internal" }, { "idrule" "complemento", "rule" "{ \\"if\\" \[{\\"!!\\" \[ { \\"var\\" \\"customer address complement\\" }] },{ \\"var\\" \\"customer address complement\\" }, \\"\\"] }", "type" "internal" } ] e por fim, o template no formato esperado pela bling na aba propriedades informamos o nome do passo e a conexão criada com a credencial da bling conclusão com o passo configurado basta disparar o fluxo informando o payload de entrada, para este caso termos esse a seguir { "number" "2304449953", "total" 3611, "promotiondiscount" 0, "shippingipi" 0, "taxsubstitution" 0, "grossamount" 3611, "createdat" "2023 04 20 11 22 16", "updatedat" "2023 04 24 10 50 13", "deletedat" null, "shippingtotal" 0, "shippingdiscount" 0, "mastersale" { "number" "2304637439" }, "status" { "name" "status paid", "info" "comprador n\u00e3o tem cr\u00e9dito pr\u00e9 aprovado", "createdat" "2023 04 24 10 50 13", "updatedby" { "email" null, "isapi" false, "issystem" true } }, "items" \[ { "name" "iphone 11 64gb branco (3798643)", "quantity" 1, "unitprice" 3611, "totalprice" 3611, "promotiondiscount" 0, "grossamount" 3611, "taxsubstitution" 0, "trackingcode" null, "additionalto" null, "shippingipi" 0, "variant" { "id" 36617, "referencecode" "3798643", "productreferencecode" "3798643", "eancode" "194252097403", "presentation" "iphone 11 64gb branco", "url" "\\/loja\\/malibu shop\\/produto\\/3798643\\/3798643", "price" 3611, "promotionalprice" null, "master" true, "masterimage" null, "isfractionalstock" false, "stock" { "quantity" 9, "minimumquantity" 2, "enabled" true, "distributioncenter" { "referencecode" "malibu shop", "postcode" "85601000", "city" "francisco beltr\u00e3o", "state" "pr", "country" "brasil", "district" "centro", "street" "avenida j\u00falio assis cavalheiro", "complement" "", "number" 390 } }, "distributioncenterlist" \[ { "quantity" 9, "minimumquantity" 2, "enabled" true, "distributioncenter" { "referencecode" "malibu shop", "postcode" "85601000", "city" "francisco beltr\u00e3o", "state" "pr", "country" "brasil", "district" "centro", "street" "avenida j\u00falio assis cavalheiro", "complement" "", "number" 390 } } ], "pricelist" null, "dimensiongroup" { "height" 40, "width" 15, "depth" 15, "weight" 0 4 }, "additionaldeliverytime" 0, "availableat" null, "deletedat" null }, "shippingaddress" { "postcode" "89053180", "city" "blumenau", "state" "sc", "country" "brasil", "street" "rua soldado m\u00e1rio luiz bertolini", "district" "itoupava norte", "complement" "zouk", "number" 416 }, "promotionsapplied" \[], "taxsubstitutionapplied" null, "taxsubstitutionsapplied" \[], "shippingmethod" { "name" "bauer transportes", "referencecode" "343243224222", "referencecodeservice" null, "estimateddeliveryfrom" 3, "estimateddeliveryto" 5, "deliverytimefrom" null, "deliverytimeto" null, "price" 0, "originalprice" 0, "discountapplied" 0, "carrier" { "referencecode" "343243224222", "name" "bauer transportes" }, "observations" null, "quoteid" null, "gatewayinfo" \[] }, "properties" \[], "itemskit" \[], "giftlist" null, "bookingstartdate" null, "bookingenddate" null, "aliquotsapplied" \[], "aliquotstotal" 0 } ], "promotionsapplied" \[], "customer" { "firstname" "thauan", "lastname" "mendes", "gender" 1, "dateofbirth" "1995 01 16", "identitynumber" "04542582248", "primaryphone" "(91) 98569 1218", "secondphone" null, "address" { "postcode" "89053180", "city" "santo andré", "state" "sp", "country" "brasil", "street" "av joão pessoa", "district" "jardim utinga", "complement" "zouk", "number" 657 }, "createdat" "2023 04 20 10 18 35", "updatedat" "2023 04 21 02 07 55", "customertype" { "name" "cooperados viacredi", "referencecode" "cooperadosviacredi", "usestaxsubstitution" false, "pricelist" null }, "pricelist" null, "email" "thauan mendes\@fluidapi io" }, "user" { "responsible" "thauan mendes", "email" "thauan mendes\@fluidapi io" }, "paymentmethods" \[ { "name" "payment method negotiable", "installments" null, "amount" 3611, "discount" 0, "addition" 0, "boletorule" null, "interestvalue" 0, "boletourl" null, "creditcardtoken" null, "authorizationcode" null, "transactionid" null, "nsu" null, "pixpaymentkey" null } ], "ordergatewayinfo" null, "shoppingstore" { "id" 2181, "name" "malibu shop", "createdat" "2022 11 01 16 03 54", "updatedat" "2022 11 08 15 46 27", "referencecode" "fluid", "logourl" "\\/\\/d8vlg9z1oftyc cloudfront net\\/ailos\\/image\\/media\\/logo malibu shop 63616d9bad209 jpeg", "faviconurl" null, "primaryphone" "(46) 99983 4080", "domain" "", "email" "contato\@malibushop com br", "useremail" "contato\@malibushop com br", "cnpj" "43 827 066\\/0001 62", "stateregistration" "", "responsiblename" "lucas rodrigues rolin", "companyname" "tecbel importa\u00e7\u00e3o e exporta\u00e7\u00e3o ltda", "tradename" "malibu shop", "isenabled" true, "isactivated" true, "address" "avenida j\u00falio assis cavalheiro, 390, centro, francisco beltr\u00e3o, pr, 85601 000, brasil", "addressobject" null, "distributioncenter" { "referencecode" "malibu shop", "postcode" "85601000", "city" "francisco beltr\u00e3o", "state" "pr", "country" "brasil", "district" "centro", "street" "avenida j\u00falio assis cavalheiro", "complement" "", "number" 390 }, "descriptionlong" null, "descriptionshort" null, "socialmedia" { "facebookurl" null, "twitterurl" null, "youtubeurl" null, "googleplusurl" null, "instagramurl" null }, "attributevalues" \[ { "name" "segmento", "referencecode" "segmento", "value" "tecnologia" }, { "name" "whatsapp", "referencecode" "whatsapp", "value" "(46) 99983 4080" }, { "name" "li e aceito os termos de uso", "referencecode" "termos vendedor", "value" "sim" }, { "name" "ip cadastro", "referencecode" "ip cadastro vendedor", "value" "187 60 223 157" }, { "name" "vers\u00e3o termos de uso", "referencecode" "versao aceite termos vendedor", "value" "v1" }, { "name" "entrega produtos no prazo", "referencecode" "entrega produtos no prazo", "value" "n\u00e3o" }, { "name" "exibir n\u00famero whatsapp no an\u00fancio", "referencecode" "exibir whatsapp", "value" "sim" }, { "name" "cooperativa", "referencecode" "campo cooperativa", "value" "evolua" }, { "name" "selo 1 cdl blumenau", "referencecode" "selo 1 cdl blumenau", "value" "n\u00e3o" }, { "name" "selo 2 aemflo", "referencecode" "selo 2 aemflo", "value" "n\u00e3o" }, { "name" "selo 3", "referencecode" "selo 3", "value" "n\u00e3o" }, { "name" "selo 4", "referencecode" "selo 4", "value" "n\u00e3o" }, { "name" "selo 5", "referencecode" "selo 5", "value" "n\u00e3o" }, { "name" "selo 6", "referencecode" "selo 6", "value" "n\u00e3o" } ] }, "agent" null, "agents" null, "subscription" null, "attributevalues" \[ { "name" "e mail do cliente", "referencecode" "ailospag user email", "value" "thauan mendes\@fluidapi io" }, { "name" "cpf", "referencecode" "ailospag cpf", "value" "04542582248" }, { "name" "cooperativa", "referencecode" "ailospag coop name", "value" "viacredi" }, { "name" "vencimento 1\u00aa parcela", "referencecode" "ailospag venc parcela", "value" "1\u00ba parcela 20\\/5\\/2023" }, { "name" "parcelas", "referencecode" "ailospag valor parcela", "value" "18" } ] } após o disparo, o resultado do fluxo aparecerá em realtime no canvas ao clicar em detalhes, temos a requisição e a resposta retornada pela bling