ReferenciaWebhooksCreación de Webhook
POST

Creación de Webhook

Endpoint

https://sellercenter-api.falabella.com/?Action=CreateWebhook

En base a una URL entregada, permite la generación de webhooks para una serie de eventos

POSTCreación de Webhook
?Action=CreateWebhook
curl -X POST "https://sellercenter-api.falabella.com/" \
  --data-urlencode "Action=CreateWebhook" \
  --data-urlencode "Format=XML" \
  --data-urlencode "Timestamp=2016-06-01T12:11+0000" \
  --data-urlencode "[email protected]" \
  --data-urlencode "Version=1.0" \
  --data-urlencode "Signature=7cd3bf58ba87e2928c8fbb93acab0fa9e88cd8086231977d5cd78c4c495bedb5"

Solicitud de carga útil

El cuerpo transmitido por el POST es una estructura XML.

Eventos relacionados a Feed
  • ●onFeedCompleted: Notificación de Feed ejecutado, puede ser con o sin rechazos
  • ●onFeedCreated: Notificación de creación de Feed
Eventos relacionados a Ordenes
  • ●onOrderCreated: Notificación de generación de creación de una nueva Orden
  • ●onOrderItemsStatusChanged: Notificación cuando existe un cambio de estado en los ítems.
Eventos relacionados a Productos
  • ●onProductCreated: Notificación de creación de nuevo producto
  • ●onProductQcStatusChanged: Notificación cuando existe un cambio en los puntos de contenido
  • ●onProductUpdated: Notificación cuando existe un cambio en el estado de un producto

Cuerpo de la solicitud

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
	<Webhook>
		<CallbackUrl>http://example.com/callback</CallbackUrl>
    <Events>
      <Event>onOrderCreated</Event>
      <Event>onProductCreated</Event>
    </Events>
	</Webhook>
</Request>
Las etiquetas XML tienen el siguiente significado:
Nombre del campoTipoComentario
CallbackUrlStringLa URL del webhook a la que llamará Falabella Seller Center
EventsEvent[]Lista de eventos relacionados con webhook identificados por su alias, consulte la llamada GetWebhookEntities para obtener más detalles.

Parámetros

Action

string
Requerido
Nombre de la función que se va a llamar. Es obligatorio y debe ser 'CreateWebhook' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory'. Si se suministra una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action'. CreateWebhook

Timestamp

date
Requerido
La hora actual en formato ISO8601 relativa a UTC (p. Ej., Marca de tiempo = 2015-04-01T10: 00: 00 + 02: 00 para Berlín), de modo que las llamadas no puedan ser reproducidas por un tercero que espíe (es decir, aquellas llamadas demasiado lejos en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se proporciona, aparece el mensaje de error 'E001: La marca de tiempo del parámetro es obligatoria'. Si la marca de tiempo es demasiado antigua o está en el futuro, se devuelve un mensaje de error "E003: Timestamp has expired" (Timestamp expiró).

Version

string
Requerido
La versión de la API contra la que se va a ejecutar esta llamada, en formato mayor-punto-menor. Debe ser actualmente 1.0, aunque la versión real de la API sea 2.6.20. Si se omite, se devuelve un mensaje de error 'E001: Parameter Version is mandatory'.

Signature

string
Requerido
La firma criptográfica que autentifica la solicitud. La persona que llama debe crear este valor calculando el hash SHA256 de la solicitud, utilizando la clave API del usuario especificado en el parámetro UserID. Obligatorio. Si se omite, se devuelve un mensaje de error 'E001: Parameter Signature is mandatory'. Si la firma es incorrecta, se devuelve un mensaje de error 'E007: Login failed. Signature mismatch'.

Format

string
Opcional
Si se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML". XML

Respuesta 200

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
     <Head>
          <RequestId/>
          <RequestAction>CreateWebhook</RequestAction>
          <ResponseType>Webhook</ResponseType>
          <Timestamp>2016-06-03T16:11:19+0200</Timestamp>
     </Head>
     <Body>
       <Webhook>
          <WebhookId>7dffaa4e-1713-42c2-84ba-1d2fbd4537ab</WebhookId>
          <CreatedAt>2016-06-03T16:11:19+0200</CreatedAt>
        </Webhook> 
     </Body>
</SuccessResponse>

Respuesta 200

{
  "SuccessResponse": {
    "Head": {
      "RequestId": "",
      "RequestAction": "CreateWebhook",
      "ResponseType": "",
      "Timestamp": "2016-06-03T16:11:49+0200"
    },
    "Body": {
      "WebhookId": "4",
      "CreatedAt": "2016-06-03T16:11:49+0200"
    }
  }
}
Descripción del error
Código de errorDescripción del error
5Invalid Request Format (Formato de solicitud no válido)
6Unexpected internal error\ (may mean feature is not configured or unknown error occurred) (Error interno inesperado\ (puede significar que la función no está configurada o que se ha producido un error desconocido))
89Required field is missing (Falta el campo obligatorio)
98Invalid Webhook Callback Url, "Given url is invalid" (La url dada no es válida)
99Invalid Webhook Event Alias, "Events alias are not matching" (Los alias de los eventos no coinciden)

Ejemplo de respuesta de error

<?xml version="1.0" encoding="UTF-8"?>
<ErrorResponse>
     <Head>
       <RequestAction>CreateWebhook</RequestAction>
       <ErrorType>Sender</ErrorType>
       <ErrorCode>96</ErrorCode>
       <ErrorMessage>
         E096: Invalid Webhook Event Alias, "Events alias are not matching"
       </ErrorMessage>
     </Head>
     <Body/>
</ErrorResponse>