Webhook

Este serviço tem como intuito notificar o ERP sobre as atualizações de status que foram causadas pelo canal de venda ou pelo usuário da plataforma.

Os Status possíveis são:

"Disconnected"

"Pending"

"Synchronized"

"Error"

"Cataloging"

"Excluded"

Mesmo com a notificação do Webhook, sugerimos a criação de um serviço de contingência que liste todos os produtos e avalie as atualizações, pois o Webhook irá fazer apenas 2 tentativas de notificação, caso ocorra algum erro a informação será descartada. Para adicionar ele basta adicionar esta integração pela plataforma, ou se utiliza nossa API basta enviar para /Setup/integration o seguinte body de exemplo:

{
    "system": "ERPProductsNotification",
    "idTenant": 2302,
    "responsibilities": [
        {
            "type": "Orders",
            "flow": "HubTo"
        }
    ],
    "apiKeys": [
        {
            "key": "URL_ERPProductsNotification",
            "value": "https://minhaUrlNotification.net/"
        },
        {
            "key": "authToken_ERPProductsNotification",
            "value": "Bearer dslfkskdjhfjkhsakdhkjsdavsdn64567sdvjdf"
        },
        {
            "key": "AuthKey_ERPProductsNotification",
            "value": "ApiKey"
        },
        {
            "key": "HUB_ID_ERPProductsNotification",
            "value": "2032"
        }
    ]
}

Assim que for adicionada a integração, dentro de alguns segundos, os produtos que tiverem seu status alterados pelo Marketplace/Ecommerce serão notificados como no exemplo abaixo:

curl --location --request POST 'https://minhaUrlNotification.net/' \
--header 'ApiKey: Bearer dslfkskdjhfjkhsakdhkjsdavsdn64567sdvjdf' \
--header 'Content-Type: application/json' \
--data-raw '{
    "idTenant": 2032,
    "sku": "999",
    "status": "Error",
    "salesChannel": "4",
    "statusMessage": "Invalid Images ..."
}'

Pra testar pode entrar na plataforma e manualmente tentar conectar um produto sem estoque, isso vai gerar uma notificação de erro. Se precisar alguma outra notificação específica pode entrar em contato com nossa equipe para auxiliar nesse teste.

Last updated