Fastcommerce Developers Center

Personalização de carrinho

Para incluir, alterar e excluir produtos do carrinho para criar promoções, brindes e outras regras de negócio, basta criar um plugin JSON, que receberá os dados do carrinho de compras. Este plugin deverá retornar um JSON com os itens do carrinho.

Seguem abaixo os formatos do JSON que enviaremos para a URL de integração e do JSON que deverá ser retornado pelo plugin.

A URL do plugin deverá ser informada no caminho PAGAMENTOS > Regras para descontos e brindes, no site administrativo da loja. Para utilizar esta URL, selecione a opção Plugin externo no campo Configuração de regras.

1 - ENVIO

                
Cart={
  "cartChangesRequest":{
    "overview":{
      "storeId": 99999,
      "sessionId": 99999999,
      "customerLogged": false,
      "customerGroup": 255,
      "customerDiscount": 50,
      "partnerId": 9999,
      "couponId": 9999,
      "currency": "R$",
      "weightUnit": "kg",
      "itemsWeight": 9999.999,
      "itemsQuantity": 9999,
      "itemsTotal": 9999.99,
      "wrapTotal": 9999.99
    },
    "items":[
      {
        "cartItemId": 99999999999,
        "cartItemDateTime": "2019-08-29T15:58:00.000Z",
        "categoryId": 9999999999,
        "categoryTree": [77656,3535,353453],
        "productId": 9999999999,
        "mainProductId": 9999999999,
        "sku": "aaaaaaaaa",
        "name": "aaaaaaaaaaaa",
        "category": "bbbbbbbb",
        "barcode": "12344",
        "stock": 99,
        "quantity": 99,
        "maxInstallments": 3,
        "ICMS": 20.3,
        "unitCost": 999.99,
        "unitPrice": 999.99,
        "unitPriceOri": 999.99,
        "unitPriceNormal": 1999.99,
        "unitWeight": 10.234,
        "unitWeightOri": 10.234,
        "color": "amarelo",
        "d1": "aaaaaaaa",
        "d2": "aaaaaaaa",
        "d3": "aaaaaaaa",
        "s1": "aaaaaaaa",
        "s2": "aaaaaaaa",
        "s3": "aaaaaaaa",
        "filterItemIds": [23,45,67,89],
        "itemFilters": "aaa=123",
        "largeProduct": false,
        "itemWrap": true,
        "wrapPrice": 999.99,
        "ruleName": "Compre dois leve três"
      },
      ...
    ]
  }
}
                
              

Obs: O envio do JSON do carrinho é feito via POST. O user-agent é Fastcommerce Cart Interface.

2 - RETORNO

Formato do JSON de retorno.

                
{
  "cartChangesResponse":{
   "err": 123
   "errDescr": "error description"
    "commands":[
      {
        "command": "ADD/DELETE/UPDATE"
        ...
      },
      {
        "command": "ADD"
        "ruleName": "compre um sapato e ganhe um brinde legal"
        "productId": 9999999999
        "color": "amarelo"
        "d1": "aaaaaaaa"
        "d2": "aaaaaaaa"
        "d3": "aaaaaaaa"
        "s1": "aaaaaaaa"
        "s2": "aaaaaaaa"
        "s3": "aaaaaaaa"
        "filters": "aaa=123"
        "quantity": 99
        "unitPrice": 999.99
        "unitWeight": 10.234
        "itemWrap": true
        "wrapPrice": 999.99
      },
      {
        "command": "DELETE"
        "cartItemId": 99999999999
      },
      {
        "command": "UPDATE"
        "ruleName": "compre um sapato e ganhe um brinde legal"
        "cartItemId": 99999999999
        "quantity": 99
        "unitPrice": 999.99
        "unitWeight": 10.234
        "itemWrap": true
        "wrapPrice": 999.99
      }
    ]
  }
}
                
              

Obs: O retorno do JSON de alterações no carrinho deverá ser feito via POST. Utilize sempre um user-agent exclusivo da sua aplicação.

03 - Dicionário de dados

JSON ENVIO

JSON RETORNO