ReferenciaÓrdenesGetOrderComments
GET
GetOrderComments
DeprecadoEndpoint
https://sellercenter-api.falabella.com/?Action=GetOrderCommentsObtener todos los comentarios que pertenecen a una misma orden.
GETGetOrderComments
?Action=GetOrderCommentscurl -G "https://sellercenter-api.falabella.com/" \--data-urlencode "Action=GetOrderComments" \--data-urlencode "OrderId=1" \--data-urlencode "Format=XML" \--data-urlencode "Timestamp=2015-07-01T11:11+0000" \--data-urlencode "[email protected]" \--data-urlencode "Version=1.0" \--data-urlencode "Signature=d4ff93cccb165295ed8357fe42082208b781a3b576bbb7d3fe7a624270b047b9"
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| CommentId | Unsigned | Identificador de este comentario asignado por el Seller Center |
| Username | String | El nombre del comentarista |
| Content | String | El cuerpo del comentario |
| Type | Enum | information\only\ action\required\ reembolso |
| IsOpened | String | Si el comentario está abierto |
| IsAnswered | String | Si el comentario ya ha sido respondido. (Útil para los tipos action_required) |
| CreatedAt | DateTime | Fecha y hora en que se añadió el comentario |
| UpdatedAt | DateTime | Fecha y hora de la última modificación del comentario |
| Comments | Array | Respuestas a los comentarios |
Parámetros
Action
string
RequeridoNombre de la función que se va a llamar. Es obligatorio y debe ser 'GetOrderComments' 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'.
GetOrderCommentsFormat
string
Si se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML".
XMLTimestamp
date
RequeridoLa hora actual en formato ISO8601 relativo a UTC (por ejemplo, Timestamp=2015-04-01T10:00:00+02:00 para Berlín), para que las llamadas no puedan ser reproducidas por un tercero que las escuche (es decir, las llamadas demasiado lejanas en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se suministra, aparece el mensaje de error "E001: Parameter Timestamp is mandatory". Si la marca de tiempo es demasiado antigua o está en el futuro, aparece un mensaje de error "E003: Timestamp has expired'.
UserID
string
El ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web de Seller Center en Configuración/Gestión de usuarios.
Version
string
RequeridoLa 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'.
Respuesta 200
<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
<Head>
<RequestId/>
<RequestAction>GetOrderComments</RequestAction>
<ResponseType>Order</ResponseType>
<Timestamp>2015-08-19T14:34:50+0200</Timestamp>
</Head>
<Body>
<Comments>
<Comment>
<CommentId>14</CommentId>
<Username>external user</Username>
<Content>Comments from SC</Content>
<Type>information_only</Type>
<IsOpened>0</IsOpened>
<IsAnswered>0</IsAnswered>
<CreatedAt>2013-09-11 23:10:55</CreatedAt>
<UpdatedAt>2013-09-11 23:10:55</UpdatedAt>
<Comments>
<Comment>
<CommentId>22</CommentId>
<Username>external user</Username>
<Content>Comments from SC</Content>
<Type>information_only</Type>
<IsOpened>0</IsOpened>
<IsAnswered>1</IsAnswered>
<CreatedAt>2013-09-11 23:10:55</CreatedAt>
<UpdatedAt>2013-09-11 23:10:55</UpdatedAt>
</Comment>
<Comment>
<CommentId>23</CommentId>
<Username>external user</Username>
<Content>Some new Comment</Content>
<Type>information_only</Type>
<IsOpened>0</IsOpened>
<IsAnswered>1</IsAnswered>
<CreatedAt>2013-09-11 23:10:55</CreatedAt>
<UpdatedAt>0000-00-00 00:00:00</UpdatedAt>
</Comment>
</Comments>
</Comment>
<Comment>
<CommentId>24</CommentId>
<Username>external user</Username>
<Content>Any comments</Content>
<Type>information_only</Type>
<IsOpened>0</IsOpened>
<IsAnswered>0</IsAnswered>
<CreatedAt>2013-09-11 23:10:55</CreatedAt>
<UpdatedAt>2013-09-11 23:10:55</UpdatedAt>
<Comments/>
</Comment>
</Comments>
</Body>
</SuccessResponse>Errores
| Código de error | Mensaje |
|---|---|
| 16 | E016: "%s" Invalid Order ID (ID de pedido inválido) |