invoice - Zuora - 如何获取发票 PDF 并显示给用户

Question

简短问题:使用get_invoices endpoint ，当我尝试从 InvoiceFiles.pdfFileUrl 响应访问 URL 时，它会弹出一个 api.zuora 登录表单。我需要我的客户能够访问这些 PDF。

如果我输入我的 Zuora 积分，它将显示发票，但我的客户当然没有 Zuora 积分。

是否有某种设置允许客户从 URL 查看 PDF？

长问题:

get_invoices endpoint返回 2 个感兴趣的项目。

body 是发票 PDF 文件的 REST URL。

和

InvoiceFiles 返回

1. id 发票 PDF 文件的 ID。这是文件对象的 ID，与 pdfFileUrl 字段中的文件句柄 ID 不同。要打开文件，您需要使用文件句柄 ID。
2. versionNumber 发票 PDF 文件的版本号
3. pdfFileUrl 发票 PDF 文件的 REST URL。单击该 URL 可打开发票 PDF 文件。

body 和 InvoiceFiles.pdfFileUrl 返回的内容有区别吗？如何正确使用它们？

pdfFileUrl 可以返回多个文件。每次更新发票(客户付款等)时，它都会生成另一个文件。最近的索引为 0。

但是尝试访问任何 URL，我都会收到 api.zuora 登录表单。如果我输入我的 Zuora 积分，它会显示发票，但当然我的客户没有 Zuora 积分。

端点页面上的示例的正文和 pdfFiles 返回为空白，因此没有太大帮助。

在他们的社区中搜索了一段时间，没有找到与我的问题远程相似的内容。

Answer 1

我们终于找到了如何做到这一点。必须在服务器端完成。

第一步是调用“/transactions/invoices/accounts/{accountId}”以获取发票列表。

其次，从列表中选择与我们尝试查看的发票编号相匹配的发票。

该对象上有一个名为“invoiceFiles”的列表 - 如果它非空，则获取第一项。

使用该项目上的“pdfFileUrl”属性作为从中获取 PDF 的 URL，但在 GET 请求中，包含 header “apiAccessKeyId”和“apiSecretAccessKey”，并将值设置为我们适用的值API key 。这消除了身份验证问题，但也使得您必须在后端执行此操作以避免暴露您的 apiAccessKeyId 和 Secret。

假设传入我们的 PDF 请求已通过身份验证，我们将对从 Zuora 返回的响应执行管道命令到我们当前在服务器上处理的传出响应:zuoraResponse.pipe(ourOutgoingResponseObj)

这将直接向用户显示 PDF。