/
WooCommerce

WooCommerce

 

WooCommerce é um plugin de comércio eletrônico de código aberto para WordPress. Ele foi projetado para comerciantes online de pequeno e grande porte que usam WordPress. O plugin rapidamente se tornou popular por sua simplicidade de instalação e personalização e pela posição de mercado do produto base como freeware.

Woocommerce é hoje uma das principais opções para lojas online e para quem deseja abrir sua loja online e atender pedidos dela.

NicoChat oferece suporte nativo à integração WooCommerce junto com todas as ações que a API WooCommerce atual suporta em seus endpoints.

Você não só pode criar automações usando NicoChat para sua loja WooCommerce, mas também criar, editar, atualizar pedidos, atendê-los, acompanhar os pedidos, remessas, avaliações etc.

Integrando sua loja WooCommerce com NicoChat

Para integrar o NicoChat à sua loja WooCommerce, você precisa fazer login na sua loja e clicar na guia WooCommerce.

f065da5a-e63e-43e2-8f78-9cf81b899a24.png

Clique em Configurações > Avançado > guia REST API

eed3c87d-f0bf-48e5-9357-2cbacf463c59.png

Clique em Adicionar chave

cf573ea5-eb40-4b9c-a3ee-c7a5ca6d0a7a.png

Insira os detalhes e crie sua chave API.

c717cc06-3b32-409e-b387-87a2b0f81042.png

Salve e copie os detalhes.

861e6d67-5dda-4322-98ea-0e2ad8919baa.png

No NicoChat, clique na aba Integrações e clique em WooCommerce para integrar sua loja.

3fd24b91-42f7-4e92-8c98-e0966db016a4.png

Usando ações WooCommerce

Para usar ações WooCommerce, crie um bloco de ação e clique em integrações para encontrar a guia WooCommerce e clique nela.

10acad74-eaf7-432f-ba60-9297f75a67a1.png

Ações nativas do WooCommerce

WooCommerce oferece suporte às seguintes ações de seus endpoints de API da seguinte maneira.

5420d26e-e628-4e10-8ef1-1f1058e73ebc.png
ba22c634-f301-4950-a5a2-18fd73bdacb2.png
45e59fac-08d6-4d89-b392-2581344c6230.png
9124bc03-c1c7-4a1d-8b9f-7cca95790d77.png
57771bf1-1c51-48ed-be1b-e6b1074aa0bf.png
5cb6290d-834f-43e4-b0d9-ae9dd415f233.png

Iremos agora explorar cada um deles em detalhes.

Adicionar ao carrinho

Esta ação é usada para adicionar um item ou produto ao carrinho do usuário.

95e50470-4aff-4097-ac5e-e100b5cec69e.png

 

A carga útil da resposta seguinte é recebida

 

{
"variant_id": 4120 ,
"product_id": 375 ,
"quantidade": 1 ,
"quantidade_anterior": 0
}

Remover carrinho por variante

Esta ação é usada para remover um item ou produto do carrinho usando sua variante e ID do produto.

4af4b181-e10e-4dc6-95ad-e35d7a7bf7ac.png

A carga útil da resposta seguinte é recebida.

{
"variant_id": 4120 ,
"product_id": 375 ,
"quantidade": 1 ,
"quantidade_anterior": 3
}

Remover carrinho por produto

Esta ação é usada para remover um item ou produto do carrinho usando apenas o ID do produto.

bde2478d-0b2a-483d-85ad-7a5f7da710ce.png

A carga útil da resposta seguinte é recebida.

{
"product_id": 375 ,
"removed_variants": [
{
"variant_id": 4120 ,
"quantidade": 1
}
]
}

Carrinho Vazio

Esta ação é usada para esvaziar o carrinho completo.

51424acf-566b-423d-8ecb-6bf7a4bbf765.png

A carga útil da resposta seguinte é recebida.

{
"status": "ok"
}

Obter itens do carrinho

Esta ação é usada para buscar todos os detalhes dos itens presentes no carrinho

594bf31f-b1cc-4a1e-8e73-4a585186c013.png

A carga útil da resposta seguinte é recebida.

[
{
"id": 258 ,
"nome": "Sapatos Pretos DNK - azul" ,
"product_id": 375 ,
"variation_id": 4120 ,
"quantidade": 2 ,
"subtotal": "350,00" ,
"subtotal_tax": "0,00" ,
"total": "350,00" ,
"total_tax": "0,00" ,
"sku": "" ,
"preço": 175 ,
"imagem": "https://shop.businessautomated.io/wp- content/uploads/2021/03/sports-shoe5.jpg" ,
"parent_name": "DNK Black Shoes"
}
]

Obtenha IDs e quantidade dos itens do carrinho

Esta ação é usada para obter os IDs e a quantidade dos itens que estão presentes no carrinho.

71ba6f90-cc19-4a26-b117-2cb492f8fc49.png

A carga útil da resposta seguinte é recebida.

[
{
"product_id": 375 ,
"quantidade": 2 ,
"variation_id": 4120
}
]

 

Criar pedido do carrinho

Esta ação é usada para criar um pedido usando itens do carrinho.

247fa852-7a51-4c81-815f-6c8d119a955b.png
17747883-f262-4bea-9c15-720071caab0f.png

A carga útil da resposta seguinte é recebida.

{
"id": 4597 ,
"parent_id": 0 ,
"status": "pendente" ,
"moeda": "AUD" ,
"versão": "6.9.4" ,
"prices_include_tax": false ,
"date_created": " 2023-04-14T11:01:51" ,
"date_modified": "2023-04-14T11:01:51" ,
"discount_total": "0,00" ,
"discount_tax": "0,00" ,
"shipping_total": "0,00" ,
"shipping_tax": "0,00" ,
"cart_tax": "0,00" ,
"total": "350,00" ,
"total_tax": "0,00" ,
"customer_id": 0 ,
"order_key": "wc_order_5hKQmDkxUiesi" ,
"faturamento" : {
"first_name": "Hammad" ,
"last_name": "Siddiqui" ,
"company": "" ,
"address_1": "ABC Road, Garden City" ,
"address_2": "" ,
"city": "Karachi " ,
"estado": "Sindh" ,
"código postal": "" ,
"país": "Paquistão" ,
"email": "hammadsiddiqui788@gmail.com" ,
"telefone": "+9230302320964"
},
"envio" : {
"first_name": "Hammad" ,
"last_name": "Siddiqui" ,
"company": "" ,
"address_1": "ABC Road, Garden City" ,
"address_2": "" ,
"city": "Karachi " ,
"estado": "Sindh" ,
"código postal": "" ,
"país": "Paquistão" ,
"telefone":""
},
"payment_method": "" ,
"payment_method_title": "" ,
"transaction_id": "" ,
"customer_ip_address": "" ,
"customer_user_agent": "" ,
"created_via": "rest-api" ,
" customer_note": "" ,
"date_completed": null ,
"date_paid": null ,
"cart_hash": "",
"número": "4597" ,
"meta_data": [
{
"id": 6465 ,
"chave": "user_ns" ,
"valor": "f12372u15376836"
}
],
"line_items": [
{
"id": 259 ,
"nome": "Sapatos pretos DNK - azul" ,
"product_id": 375 ,
"variation_id": 4120 ,
"quantidade": 2 ,
"tax_class": "" ,
"subtotal": "350,00" ,
"subtotal_tax": "0.00" ,
"total": "350.00" ,
"total_tax": "0.00" ,
"taxes": [...], // 0 itens
"meta_data": [...], // 1 item
"sku ": "" ,
"price": 175 ,
"image": {...}, // 2 chaves
"parent_name": "DNK Black Shoes"
}
],
"tax_lines": [
],
"shipping_lines": [
] ,
"fee_lines": [
],
"coupon_lines": [
],
"refunds": [
],
"payment_url": "https://shop.businessautomated.io/checkout-2/order-pay/4597?pay_for_order=true&key =wc_order_5hKQmDkxUiesi" ,
"is_editable": true ,
"needs_payment": true ,
"needs_processing": true , "
date_created_gmt ": " 2023-04-14T11:01:51" ,
"date_modified_gmt": "2023-04-14T11:01 :51" ,
"date_completed_gmt": null ,
"date_paid_gmt": null ,
"currency_symbol": "$"
}

Pesquisar cupons

Esta ação é usada para pesquisar cupons disponíveis em sua loja woocommerce em diversos parâmetros de pesquisa e consultas.

9c8ddb87-52d3-40a1-98ca-432dd97ef684.png

A carga útil da resposta seguinte é recebida.

[
{
"id": 4592 ,
"código": "vipdiscount60fc" ,
"quantia": "10.00" ,
"status": "publicar" ,
"date_created": "2023-01-25T06:56:57" ,
"date_created_gmt ": "2023-01-25T06:56:57" ,
"date_modified": "2023-01-25T06:56:57" ,
"date_modified_gmt": "2023-01-25T06:56:57" ,
"discount_type": "percent" ,
"description": "10% de desconto em todo o pedido, uso único" ,
"date_expires": null ,
"date_expires_gmt": null ,
"usage_count": 1 ,
"individual_use": false ,
"product_ids": [
] ,
"excluded_product_ids": [
],
"usage_limit": 1 ,
"usage_limit_per_user": 1 ,
"limit_usage_to_x_items": null ,
"free_shipping": false ,
"product_categories": [
],
"excluded_product_categories": [
],
"exclude_sale_items": false ,
"valor_mínimo": "0,00" ,
"valor_máximo": "0,00" ,
"email_restrictions": [
],
"used_by": [
"mark@doe.com"
],
"meta_data": [
],
"_links": {
"self": [...], // 1 item
"coleção": [...] // 1 item
}
}
]

Obtenha informações do cupom

Esta ação é usada para buscar informações de um cupom específico usando seu ID de cupom.

82a5f139-7b64-456d-94af-0c638b2445b3.png

A carga útil da resposta seguinte é recebida.

{
"id": 4592 ,
"código": "vipdiscount60fc" ,
"quantidade": "10.00" ,
"status": "publicar" ,
"date_created": "2023-01-25T06:56:57" ,
"date_created_gmt" : "2023-01-25T06:56:57" ,
"date_modified": "2023-01-25T06:56:57" ,
"date_modified_gmt": "2023-01-25T06:56:57" ,
"discount_type": " percent" ,
"description": "10% de desconto em todo o pedido, uso único" ,
"date_expires": null ,
"date_expires_gmt": null ,
"usage_count": 1 ,
"individual_use": false ,
"product_ids": [
],
"excluded_product_ids": [
],
"usage_limit": 1 ,
"usage_limit_per_user": 1 ,
"limit_usage_to_x_items": null ,
"free_shipping": false ,
"product_categories": [
],
"excluded_product_categories": [
],
"exclude_sale_items": false ,
"valor_mínimo": "0,00" ,
"valor_máximo": "0,00" ,
"email_restrictions": [
],
"used_by": [
"mark@doe.com"
],
"meta_data": [
]
}

Excluir cupom

Esta ação é usada para excluir um cupom com base em seu ID de cupom.

fcfab959-816b-4e1f-8485-f66b01e0e6f1.png

A carga útil da resposta seguinte é recebida.

{
"status": "ok"
}

Criar cupom

Esta ação é usada para criar um cupom.

0bb4da3c-60b3-4936-bb1b-289966045d74.png
1b5c8dc4-665d-427d-b5fb-395f1489cb70.png

A carga útil da resposta seguinte é recebida.

{
"id": 4598 ,
"código": "test12" ,
"quantidade": "10.00" ,
"status": "publicar" ,
"date_created": "2023-04-14T14:27:49" ,
"date_created_gmt" : "2023-04-14T14:27:49" ,
"date_modified": "2023-04-14T14:27:49" ,
"date_modified_gmt": "2023-04-14T14:27:49" ,
"discount_type": " por cento" ,
"descrição": "cupom de teste" ,
"date_expires": "2023-05-01T00:00:00" ,
"date_expires_gmt": "2023-05-01T00:00:00" ,
"usage_count": 0 ,
"individual_use": false ,
"product_ids": [
],
"excluded_product_ids": [
],
"usage_limit": 1 ,
"usage_limit_per_user": 1 ,
"limit_usage_to_x_items": null ,
"free_shipping": false ,
"product_categories": [
] ,
"excluded_product_categories": [
],
"exclude_sale_items": false ,
"minimum_amount": "0,00" ,
"maximum_amount": "0,00" ,
"email_restrictions": [
],
"used_by": [
],
"meta_data": [
]
}

Cupom de atualização

Esta ação é usada para atualizar um cupom usando seu ID de cupom.

54aa58d8-683f-462c-9289-dd78d06bc4b1.png

A carga útil da resposta seguinte é recebida.

{
"id": 4598 ,
"código": "test12" ,
"quantidade": "15.00" ,
"status": "publicar" ,
"date_created": "2023-04-14T14:27:49" ,
"date_created_gmt" : "2023-04-14T14:27:49" ,
"date_modified": "2023-04-14T14:27:49" ,
"date_modified_gmt": "2023-04-14T14:27:49" ,
"discount_type": " por cento" ,
"descrição": "cupom de teste" ,
"date_expires": "2023-05-01T00:00:00" ,
"date_expires_gmt": "2023-05-01T00:00:00" ,
"usage_count": 0 ,
"individual_use": false ,
"product_ids": [
],
"excluded_product_ids": [
],
"usage_limit": 3 ,
"usage_limit_per_user": 1 ,
"limit_usage_to_x_items": null ,
"free_shipping": false ,
"product_categories": [
] ,
"excluded_product_categories": [
],
"exclude_sale_items": false ,
"minimum_amount": "0,00" ,
"maximum_amount": "0,00" ,
"email_restrictions": [
],
"used_by": [
],
"meta_data": [
]
}

Pesquisar clientes

Esta ação é utilizada para buscar clientes por meio de diversos parâmetros e consultas.

9bf101d7-66d9-47df-83d9-5ac48a433160.png

A carga útil de resposta seguinte foi recebida.

[
{
"id": 2 ,
"date_created": "2022-10-10T01:24:22" ,
"date_created_gmt": "2022-10-10T01:24:22" ,
"date_modified": "2022-10-10T01 :24:22" ,
"date_modified_gmt": "2022-10-10T01:24:22" ,
"email": "test@test.com" ,
"first_name": "" ,
"last_name": "last" ,
" função": "cliente" ,
"nome de usuário": "teste" ,
"faturamento": {
"nome_nome": "" ,
"sobrenome": "" ,
"empresa": "" ,
"endereço_1": "" ,
"endereço_2 ": "" ,
"cidade": "" ,
"código postal": "" ,
"país": "" ,
"estado": "" ,
"e-mail": "" ,
"telefone": ""
},
"envio ": {
"primeiro_nome": "" ,
"sobrenome": "" ,
"empresa": "" ,
"endereço_1": "" ,
"endereço_2": "" ,
"cidade": "" ,
"código postal": " " ,
"país": "" ,
"estado": "" ,
"telefone": ""
},
"is_paying_customer": false ,
"avatar_url": "https://secure.gravatar.com/avatar/b642b4217b34b1e8d3bd915fc65c4452?s =96&d=mm&r=g" ,
"meta_data": [
{...} // 3 chaves
],
"_links": {
"self": [...], // 1 item
"coleção": [.. .] // 1 itens
}
},
{
"id": 5 ,
"date_created": "2022-10-12T16:32:26" ,
"date_created_gmt": "2022-10-12T16:32:26" ,
"date_modified": "2022-10-12T16:32:26" ,
"date_modified_gmt ": "2022-10-12T16:32:26" ,
"email": "mark@NicoChat.com.br" ,
"first_name": "Mark" ,
"last_name": "van der Made" ,
"função": "cliente" ,
"nome de usuário": "markvdmade",
"faturamento": {
"nome_nome": "Mark" ,
"sobrenome": "van der Made" ,
"empresa": "" ,
"endereço_1": "palmonostora 143" ,
"endereço_2": "" ,
"cidade" : "Palmonostora" ,
"código postal": "6112" ,
"país": "Hungria" ,
"estado": "bacs-kiskun" ,
"email": "mark@NicoChat.com.br" ,
"telefone": " +36707203759"
},
"shipping": {
"first_name": "Mark" ,
"last_name": "van der Made" ,
"company": "" ,
"address_1": "palmonostora 143" , "address_2": "" , "cidade": "Palmonostora" , "código postal": "6112" , "país": "Hungria" , "estado": "bacs-kiskun" , "telefone": "" }, "is_paying_customer": false , " avatar_url": "https://secure.gravatar.com/avatar/f96de5c9ef467d55b706b615b56a641b?s=96&d=mm&r=g" , "meta_data": [ ], "_links": { "self": [...], / / 1 itens "coleção": [...] // 1 itens } } ]