Lengow允许您上传您的客户发票,以将它们提交给任何Mirakl市场。
您有3种方式将客户发票发送到Mirakl市场:
- 通过Lengow API
- 在Lengow平台
- 在您的Mirakl后台办公室
注意:不能通过您的CMS中的Lengow插件上传发票。
通过API上传
- 市场API:"invoice_upload"参数
如果市场允许上传发票,您将在市场API中找到invoice_upload参数。
Decathlon的示例:
"decathlon_eu_be_fr": {
"logo": "",
"name": "Decathlon BE (French)",
"orders": {},
"country": "BEL",
"package": "sp_decathlon_eu.mp.be_fr",
"features": {
"invoice_upload": true
- 订单API:API调用
端点:https://api.lengow.io/v3.0/document/
进行以下API调用以上传客户发票:
curl --location 'https://api.lengow.io/api/v3.1/document/' \
--form 'order_id="5137116-A"' \
--form 'account_id="58"' \
--form 'metadata="{\"document_number\":\"123\",\"issue_date\":\"2024-10-17T00:00:00Z\",\"due_date\":\"2024-10-18T00:00:00Z\",\"total_amount_excluding_taxes\":31.99,\"total_tax_amount\":3.19}"' \
--form 'marketplace="decathlon_eu_be_fr"' \
--form 'upload=@"/C:/Users/invoices/ma_facture.pdf"'关于此调用的参数的信息:
- 所有参数都以form-data的形式发送
- 所有参数都是文本字段,除了upload,它是一个"files"字段
-
metadata必须包含这些参数:
- document_number:发票号码作为字符串。
- issue_date:字符串,ISO UTC日期格式:YYYY-MM-ddTHH:MM:SSZ
- due_date:字符串,ISO UTC日期格式:YYYY-MM-ddTHH:MM:SSZ
- total_amount_excluding_taxes:浮点整数,保留两位小数。例如:31.99
- total_tax_amount:浮点整数,保留两位小数。例如:3.19
-
upload:客户发票必须以xml或pdf格式发送。文件的最大大小:20 Mo
有关更多信息,请参阅我们的API文档
在Lengow平台中上传
要在Lengow平台中上传发票:
- 在Lengow的订单部分,转到您订单的详细页面;
- 点击页面右下角的上传图标,然后点击"上传发票";
- 一个窗口打开,允许您填写请求的信息并选择要上传的发票(见截图);
- 准备好后,点击"发送"将订单的发票传送到市场。
如果您没有看到这个图标,那就意味着市场还没有激活上传发票的选项。
在您的Mirakl后台上传
要在您的Mirakl后台上传客户订单的发票,请转到订单详情页面。
在屏幕的右上角,点击"More actions",然后点击"Documents"。在"会计文件"部分,您可以为此订单上传客户发票。
例如,对于Decathlon,详细的过程在他们的文档中提供。