User Tools

Site Tools


relesenote_datafeed_09182018

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

relesenote_datafeed_09182018 [2018/09/18 16:30]
jn34 created
relesenote_datafeed_09182018 [2018/09/20 07:25] (current)
jn34
Line 1: Line 1:
 +==== Taxes, Duties, and Import Charges for Shipments to China ====
 +
 +Specify Settings on Item Level (Optional)
 +
 +By submitting this template, you will be able to set the tax type for the items sold for China. ​
 +
 +**Release Date:** September 17, 2018
 +**Last Updated:** September 17, 2018
 +  * For data feed template, please download ​ it from Seller Portal > Mange Items > Batch Item Tax Settings
 +  * For API schema, please download the XSD’s and XML sample files from \\ [[https://​sellerportal.newegg.com/​Guideline/​Newegg_Marketplace_API_DeveloperGuide.zip]]
 +
 +The following information provides element definitions. You can also contact Newegg Marketplace Integration team: [[datafeeds@newegg.com]] for assistance.
 +
 +^Attribute ^Format ^Definition ^Required ^
 +|SellerPartNumber|String|A seller-defined unique identifier for an item.|Y if NeweggItemNumber not provided.|
 +|NeweggItemNumber|String|Newegg’s unique identifier for an item.|Y if SellerPartNumber not provided.|
 +|TaxDutyType|String|Identify the tax and duty rules for items shipped to China by seller directly. Available values: • Default: Follow the account level setting \\ • DDU: Deliver Duties Unpaid. No duty or tax will be added to orders. Customers are responsible for additional duties and taxes during the customs clearance. \\ • DDP: Deliver Duties Paid. Duties and taxes will be collected while customers placing orders. Sellers are responsible to pay all duties and taxes directly. Collected amount will be remit to sellers along with regular payment transactions. \\ • ATI: All tax included. All duties and taxes are included in item’s selling price. No duty or tax will be added to orders. Sellers are responsible to pay all duties and taxes directly.| Y |
 +|ImportType|String|Identify the order import type for calculating the correct tax amount for items shipping to China by Seller (SBS). Available values: \\ • Default: Follow the account level setting \\ • EE: Taxes will be calculated as personal shipments. Recipient’s photo ID number and the copy of ID will be provided for processing orders. \\ • EEP: Taxes will be calculated as business to customer direct shipments, known as Cross-Border e-Commerce. Payment holder’s photo ID number will be provided for processing orders.|Y|
 +
 +=== Tax Setting Report for Items Enabled for China ===
 +
 +By submitting this API request, the item level report can be retrieved for the settings on item level. ​
 +
 +**Release Date:** September 17, 2018
 +**Created On:** September 17, 2018
 +**Last Updated:** September 17, 2018
 +  * For API schema, please download the XSD’s and XML sample files from \\ [[https://​sellerportal.newegg.com/​Guideline/​Newegg_Marketplace_API_DeveloperGuide.zip]]
 +
 +The following information provides element definitions. You can also contact Newegg Marketplace Integration team: [[datafeeds@newegg.com]] for assistance.
 +
 +**Report Request**
 +
 +^Attribute ^^^^Required?​ ^Format ^Description ^
 +|NeweggAPIRequest |IssueUser |||No |String |Specify your eligible seller account (email address) here |
 +|:::​|OperationType |||Yes |String |Fixed value: ItemChinaTaxSettingReportRequest|
 +|:::|   ​| ​  ​|RequestType |Yes |String |ITEM_CHINATAXSETTING_REPORT |
 +|:::​|:::​|:::​|FileType |No |String |Default FileType is txt. If you do not set the FileType, our system will auto generate file for you in .txt file format. \\ Currently only support the following file formats: \\ CSV \\ XLS \\ TXT|
 +
 +Example: XML, Reponses
 +
 +XSD \\
 +API Schema > ReportMgmt > SubmitReport > ItemChinaTaxSettingReportRequest.xsd
 +  ​
 +  POST https://​api.newegg.com/​marketplace/​reportmgmt/​report/​submitrequest?​sellerid={sellerid}
 +  Authorization:​ 720ddc067f4d115bd544aff46bc75634
 +  SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
 +  Content-Type:​ application/​xml
 +  Accept: application/​xml
 +  ​
 +  <​NeweggAPIRequest>​
 +  <​OperationType>​ItemChinaTaxSettingReportRequest</​OperationType>​
 +  <​RequestBody>​
 +    <​ItemChinaTaxSettingReportCriteria>​
 +      <​RequestType>​ITEM_CHINATAXSETTING_REPORT</​RequestType>​
 +      <​FileType>​XLS</​FileType>​
 +    </​ItemChinaTaxSettingReportCriteria>​
 +  </​RequestBody>​
 +  </​NeweggAPIRequest>​
 +
 +Example: Json, Request
 +
 +   POST https://​api.newegg.com/​marketplace/​reportmgmt/​report/​submitrequest?​sellerid={sellerid}
 +   ​Authorization:​ 720ddc067f4d115bd544aff46bc75634
 +   ​SecretKey:​ 21EC2020-3AEA-1069-A2DD-08002B30309D
 +   ​Content-Type:​ application/​json
 +   ​Accept:​ application/​json
 +   
 +  {
 +     "​OperationType":​ "​ItemChinaTaxSettingReportRequest",​
 +     "​RequestBody":​ {
 +       "​ItemChinaTaxSettingReportCriteria":​ {
 +         "​RequestType":​ "​ITEM_CHINATAXSETTING_REPORT",​
 +         "​FileType":​ "​XLS"​
 +       }
 +     }
 +  }
 +
 +Report Result
 +
 +^Attribute ^^^Format ^Description ^
 +|NeweggAPIResponse |IsSuccess ||String |Used to identify the operation is successful. Returns true or false. |
 +|:::​|SellerID ||String |Your seller ID |
 +|:::​|OperationType ||String |Fixed value: ItemChinaTaxSettingReportResponse |
 +|:::​|Response Body |RequestID |String |You request ID |
 +|:::​|:::​|RequestType |String |ITEM_CHINATAXSETTING_REPORT |
 +|:::​|:::​|RequestDate |String |You request datetime(Pacific Standard Time) |
 +|:::​|:::​|ReportFileURL |string |The ftp file path, where you can get the report result file. \\ For example: \\ ftp://​API-52qNFlUQ:​pKLgE2aE@ftp03.newegg.com/​ItemChinaTaxSettingReport_2PN75DT8ZICH8.zip|
 +|:::​|Memo ||String |Additional Information. ​ |
 +
 +Example: XML, Response \\
 +XSD \\
 +API Schema > ReportMgmt > GetReport > ItemChinaTaxSettingReportResponse.xsd
 +
 +  <?xml version="​1.0"​ encoding="​utf-8"?>​
 +  <​NeweggAPIResponse>​
 +    <​IsSuccess>​true</​IsSuccess>​
 +    <​sellerID>​A006</​sellerID>​
 +    <​OperationType>​ItemChinaTaxSettingReportResponse</​OperationType>​
 +    <​ResponseBody>​
 +      <​RequestID>​2PQC13C7UYDPQ</​RequestID>​
 +      <​RequestType>​ITEM_CHINATAXSETTING_REPORT</​RequestType>​
 +      <​RequestDate>​2/​21/​2012 15:​32:​57</​RequestDate>​
 +      <​ReportFileURL>​ftp://​API-e6Cl2FfE:​M9RUtm2s@ftp03.newegg.com/​InternationalPriceReport_2PQC13C7UYDPQ.zip</​ReportFileURL>​
 +    </​ResponseBody>​
 +    <Memo />
 +  </​NeweggAPIResponse>​
 +
 +Example: Json, Response
 +
 +  {
 +      "​NeweggAPIResponse":​ {
 +          "​IsSuccess":​ "​true",​
 +          "​sellerID":​ "​A006",​
 +          "​OperationType":​ "​ItemChinaTaxSettingReportResponse",​
 +          "​ResponseBody":​ {
 +              "​RequestID":​ "​2PQC13C7UYDPQ",​
 +              "​RequestType":​ "​ITEM_CHINATAXSETTING_REPORT",​
 +              "​RequestDate":​ "​2/​21/​2012 15:​32:​57",​
 +              "​ReportFileURL":​ "​ftp://​API-e6Cl2FfE:​M9RUtm2s@ftp03.newegg.com/​ItemChinaTaxSettingReport_2PQC13C7UYDPQ.zip"​
 +          },
 +          "​Memo":​ null
 +      }
 +  }
 +
 +
 +
 +[[Update History|Back]]
 +
 +
  

Page Tools