Discussion

Method :
GetDiscussionList

Get a discussion list.

This operation makes it possible to manage every type of discussions.

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<GetDiscussionList>
    <discussionFilter>
        <BeginCreationDate>{{BeginCreationDate}}</BeginCreationDate>
        <BeginModificationDate>{{BeginModificationDate}}</BeginModificationDate>
        <EndCreationDate>{{EndCreationDate}}</EndCreationDate>
        <EndModificationDate>{{EndModificationDate}}</EndModificationDate>
        <StatusList>
            <DiscussionStateFilter>{{DiscussionStateFilter}}</DiscussionStateFilter>
        </StatusList>
        <DiscussionType>{{DiscussionType}}</DiscussionType>
        <OrderNumberList>
            <arr:string>{{OrderNumber}}</arr:string>
        </OrderNumberList>
        <ProductEanList>
            <arr:string>{{ProductEanList}}</arr:string>
        </ProductEanList>
        <ProductSellerReferenceList>
            <arr:string>{{ProductSellerReferenceList}}</arr:string>
        </ProductSellerReferenceList>
    </discussionFilter>
</GetDiscussionList>

Route :
GET /discussions

Use this API to search discussions by filter parameters.

Request URL

GET /categories?pageIndex=100&fields=label,IsActive,parentReference,level,parentReferences,isBrandMandatory

Sample Response

{
  "discussionId": "652e92fc3b6ff8977effe471",
  "subject": "[CERTIFIEE] Demande de modification d'adresse de livraison 17/10/2023 15:58:01",
  "orderReference": "2310171354KBDRE",
  "orderSellerId": "2310171354KBDRE",
  "salesChannelExternalReference": "288598169",
  "isOpen": true,
  "graduation": "Discussion",
  "subTypologyCode": "orderAddressChangeCdiscount",
  "typologyCode": "Order",
  "createdAt": "2023-10-17T13:58:01.413Z",
  "updatedAt": "2023-10-17T13:58:01.32Z",
  "status": "ToTreat",
  "customerId": "0000000403YZ",
  "sellerId": "98979",
  "salesChannel": "CDISFR"
}

Method :
GetDiscussionList

Get a discussion attachments.

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<GetDiscussionList>
    <discussionFilter>
        <BeginCreationDate>{{BeginCreationDate}}</BeginCreationDate>
        <BeginModificationDate>{{BeginModificationDate}}</BeginModificationDate>
        <EndCreationDate>{{EndCreationDate}}</EndCreationDate>
        <EndModificationDate>{{EndModificationDate}}</EndModificationDate>
        <StatusList>
            <DiscussionStateFilter>{{DiscussionStateFilter}}</DiscussionStateFilter>
        </StatusList>
        <DiscussionType>{{DiscussionType}}</DiscussionType>
        <OrderNumberList>
            <arr:string>{{OrderNumber}}</arr:string>
        </OrderNumberList>
        <ProductEanList>
            <arr:string>{{ProductEanList}}</arr:string>
        </ProductEanList>
        <ProductSellerReferenceList>
            <arr:string>{{ProductSellerReferenceList}}</arr:string>
        </ProductSellerReferenceList>
    </discussionFilter>
</GetDiscussionList>

Route :
GET /discussions/{discussionId}

Use this route to get full discussion with attachments.

Request URL

GET /discussions/{discussionId}

Sample Response

{
  "discussionId": "507f1f77bcf86cd799439011",
  "messageId": "807f1f77bcf86cd799439044",
  "salesChannelExternalReference": "507f1f77bcf8",
  "body": "Message text",
  "salesChannel": "CASIFR",
  "createdAt": "2021-05-06T03:52:17Z",
  "updatedAt": "2021-05-06T03:52:17Z",
  "attachmentCount": 1,
  "sender": {
    "userId": "1653fr3",
    "userType": "Seller"
  },
  "receivers": [
    {
      "userId": "123",
      "userType": "Customer",
      "hasRead": true,
      "readDate": "2021-05-06T03:52:17Z"
    }
  ],
  "attachments": [
    {
      "discussionId": "507f1f77bcf86cd799439011",
      "messageId": "807f1f77bcf86cd799439044",
      "attachmentId": "60ab64fa37efec0001dd39b6",
      "attachmentName": "The name of the attachment",
      "fileFormat": "pdf"
    }
  ]
}

Method :
CloseDiscussionList

This method allows to close a discussion list

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<cdis:CloseDiscussionList>
    <cdis:closeDiscussionRequest>
        <cdis:DiscussionIds>
            <arr:long>{{DiscussionIds}}</arr:long>
        </cdis:DiscussionIds>
    </cdis:closeDiscussionRequest>
</cdis:CloseDiscussionList>

Route :
PATCH /discussions/{{discussionId}}

This route allows you to replace properties in the discussion object. Currently you can change only the isOpen property.

Request URL

PATCH /discussions/{discussionId}

Body Payload

{
  "opt": "replace",
  "path": "/isOpen",
  "value": "false"
}

Sample Response

Response: 204 No Content

You’ve reached the end of this Migration Guide, next step is to dive in the technical documentation.