如何从tradeShift API中获取采购订单文档？

Question

我正在尝试使用他们的API获得贸易转移采购订单。

FYI，当我提出API请求时，

• 我正在使用OAuth1。
• 我使用端点https://api-sandbox.tradeshift.com/tradeshift/rest/external/documents?limit=5

在标题中，当我将Accept设置为application/JSON时，我将得到如下所示的响应

{
  "itemsPerPage": 5,
  "itemCount": 2,
  "indexing": false,
  "numPages": 1,
  "pageId": 0,
  "Document": []
}

但是，如果我在Header中没有添加任何内容，我将得到一个XML响应。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ts:DocumentList xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:ts="http://tradeshift.com/api/public/1.0" xmlns:ns6="http://tradeshift.com/api/1.0" xmlns:ns7="http://tradeshift.com/api/2.0" xmlns:ns8="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:ns9="urn:oasis:names:specification:ubl:schema:xsd:Quotation-2" xmlns:ns10="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2" xmlns:ns11="urn:oasis:names:specification:ubl:schema:xsd:Order-2" xmlns:ns12="urn:oasis:names:specification:ubl:schema:xsd:OrderChange-2" xmlns:ns13="urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2" xmlns:ns14="urn:oasis:names:specification:ubl:schema:xsd:Reminder-2" xmlns:ns15="urn:oasis:names:specification:ubl:schema:xsd:RemittanceAdvice-2" xmlns:ns16="urn:oasis:names:specification:ubl:schema:xsd:ReceiptAdvice-2" xmlns:ns17="urn:oasis:names:specification:ubl:schema:xsd:Catalogue-2" xmlns:ns18="https://tradeshift.com/documents/ubl/xsd/Requisition-2" xmlns:ns19="urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2" xmlns:ns20="urn:oasis:names:specification:ubl:schema:xsd:RequestForQuotation-2" xmlns:ns21="urn:oasis:names:specification:ubl:schema:xsd:OrderResponseSimple-2" xmlns:ns22="urn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-2" xmlns:ns23="urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-2" indexing="false" numPages="1" pageId="0" itemsPerPage="5" itemCount="2"/>

我不太确定文档是否已经以UBL格式存在。

如果文档已经以UBL的形式存在，请您确保。

如果文档存在，那么我如何解析文档？如果文档不在那里，我如何才能得到这些文档？

Answer 1

文档不在那里，两种响应都是相同的，只是格式不同。为了获得您在Tradeshift帐户中收到的文件，您应该遵循以下步骤：

1. 使用下面的API：GET https://api-sandbox.tradeshift.com/tradeshift/rest/external/documents?type=order Content-Type=application/json Accept=application/json Authorisation=oauth1获取包含帐户中所有可用文档的列表

作为响应，您将获得一个JSON，其中包含帐户中的所有订单以及检索订单的UBL文件所需的详细信息。

1. 从JSON得到的第1点，使用您希望得到的顺序的DocumentId进行以下调用，GET https://api-sandbox.tradeshift.com/tradeshift/rest/external/documents/{DocumentUUID} Content-Type=application/json Accept=application/xml Authorisation=oauth1
2. 一旦您得到一个文件，为了将它标记为已处理，您还可以使用下面的API调用来标记文档： PUT https://api.tradeshift.com/tradeshift/rest/external/documents/{DocumentId}/tags/{your-tag}

在第一个调用中，您可以添加更多的参数，如而不带，以便筛选出已经标记的文档，如下所示：

`GET https://api-sandbox.tradeshift.com/tradeshift/rest/external/documents?type=order&withouttag={your-tag}`