{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/duties-and-taxes-payment","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/shipping/duties-and-taxes-payment","default":true,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/duties-and-taxes-payment","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Duties and Taxes Payment","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"duties-and-taxes-payment","__idx":0},"children":["Duties and Taxes Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you ship internationally with DDP (Delivered Duty Paid), you pay the destination country's duties, taxes and"," ","import fees instead of the recipient. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advanced_options.duties_and_taxes_payment"]}," field controls how you pay them."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What happens"},"children":["What happens"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Carriers"},"children":["Carriers"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The duties and taxes are fixed when the label is created and charged to you. The recipient is not billed for them. Rates and labels return them as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_duties"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_taxes"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_import_fees"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wallet carriers, and eligible BYOA (Bring Your Own Account) carriers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The carrier bills the actual duties and taxes to your own carrier account later. Rates and labels return an estimate as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["estimated_duties"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["estimated_taxes"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["estimated_import_fees"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BYOA carriers only"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The shipment must be DDP: set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advanced_options.delivered_duty_paid"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs.terms_of_trade_code"]}," to"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ddp"]},". Sending ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duties_and_taxes_payment"]}," without DDP, or with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs.terms_of_trade_code: ddu"]},", returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_conflict"]}," error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," needs an international shipment from a supported origin country, on a carrier that is enabled for"," ","guaranteed duties and taxes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," on a BYOA carrier is paid from your US managed funding source (ShipStation Balance). Only US origins are"," ","supported, and the funding source must have enough funds to cover the duties and taxes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]}," is not available on Wallet carriers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"default-when-the-field-is-omitted","__idx":2},"children":["Default When the Field Is Omitted"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["BYOA carriers use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]},". The carrier bills the duties and taxes to your carrier account, and your funding"," ","source is never charged for them unless you send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wallet carriers use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," when the shipment is eligible for guaranteed duties and taxes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Shipment responses return the value in effect. This includes the shipment returned by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/rates"]},". Label"," ","responses don't include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advanced_options"]},". The value is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when the shipment isn't DDP, has no carrier, or uses a"," ","Wallet carrier and isn't eligible for guaranteed duties and taxes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"which-carriers-support-each-value","__idx":3},"children":["Which Carriers Support Each Value"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/carriers"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/carriers/{carrier_id}"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/carriers/{carrier_id}/services"]}," all return"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supported_duties_and_taxes_payments"]},". It is always present and can be empty."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Carrier"},"children":["Carrier"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wallet carrier, guaranteed enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"guaranteed\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wallet carrier, guaranteed not enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BYOA carrier, guaranteed enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"guaranteed\", \"carrier_billed\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BYOA carrier, guaranteed not enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"carrier_billed\"]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Services that are domestic only return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]},". International services return their carrier's list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a capability, not a promise for a specific shipment. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," is listed when guaranteed duties and taxes are"," ","enabled for the carrier and your account for at least one origin country. A shipment can still be rejected because of"," ","its origin, its destination or its customs data. Your funding source isn't part of the check either, so a BYOA carrier"," ","can list ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," and still return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["funding_source_missing_configuration"]}," when you create a label."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":4},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The duties and taxes fields of a shipment. The other shipment fields (addresses, packages, customs items) are the same"," ","as for any international shipment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipment\": {\n    \"carrier_id\": \"se-123456\",\n    \"service_code\": \"ups_worldwide_expedited\",\n    \"customs\": {\n      \"contents\": \"merchandise\",\n      \"non_delivery\": \"return_to_sender\",\n      \"terms_of_trade_code\": \"ddp\"\n    },\n    \"advanced_options\": {\n      \"duties_and_taxes_payment\": \"guaranteed\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send this to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/labels"]},", or send the same shipment to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/rates"]},". You can also set the field"," ","when you create or update a shipment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rates","__idx":5},"children":["Rates"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]},": rates include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_duties"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_taxes"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid_import_fees"]}," rate details."," ","When guaranteed duties and taxes aren't available for a carrier and shipment, that carrier's rates are returned in"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_rates"]}," with an error message saying so. This also happens for a BYOA carrier when your account has no US"," ","managed funding source. If the guaranteed amount can't be quoted, the carrier's rates aren't returned and the error"," ","is listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]}," or omitted on a BYOA carrier: when an estimate is available for the shipment, rates include the"," ","estimated duties and taxes and the warning ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Duties & taxes amount is an estimate and may differ from final carrier charge."]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warning_messages"]},". If the estimate can't be calculated, the rate is still returned without the estimate"," ","and with the warning ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Duties & taxes estimate is unavailable for this rate."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]}," on a Wallet carrier: when the shipment's own ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," is a Wallet carrier, the request returns a"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_field_value"]}," error. When a Wallet carrier is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rate_options.carrier_ids"]},", the response has an error"," ","for that carrier and no rates from it. Otherwise Wallet carriers are skipped."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rate estimates (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/rates/estimate"]},") don't support the field. They always return estimated duties and taxes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Bulk rates (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/rates/bulk"]},") don't apply the field when the rates are calculated, so a bulk rate can show"," ","estimated duties and taxes when you asked for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]},". When you read the results with"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/shipments/{shipment_id}/rates"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/rates/{rate_id}"]},", rates from carriers that can't provide the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," duties and taxes you asked for are returned in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_rates"]},". The label checks below still apply when"," ","you purchase a label from a bulk rate."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"label-errors","__idx":6},"children":["Label Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first three rows apply to any value of the field. The next two apply only when you send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]},". The last four"," ","apply whenever the label gets guaranteed duties and taxes, including when you omit the field on an eligible Wallet"," ","carrier. Except where noted, no label is purchased."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Situation"},"children":["Situation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP status"},"children":["HTTP status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"error_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"error_code"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duties_and_taxes_payment"]}," without DDP, or with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs.terms_of_trade_code: ddu"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_conflict"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duties_and_taxes_payment"]}," combined with a partner-specific duties and taxes option"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_conflict"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]}," on a Wallet carrier, including a label purchased from a rate ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_field_value"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guaranteed"]}," isn't available for this carrier and shipment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_field_value"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BYOA carrier and no US managed funding source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["funding_sources"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["funding_source_missing_configuration"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The duties and taxes validation rejected the shipment, for example a missing or invalid HS code. The message starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Duties and taxes validation failed:"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_field_value"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The duties and taxes service couldn't be reached or returned an error. Try again later."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["system"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unspecified"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The funding source doesn't have enough funds. The label was purchased, then voided, and is not returned."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["402"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insufficient_funds"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The duties and taxes couldn't be charged for another reason. The label was purchased, then voided, and is not returned."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unspecified"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All of these errors have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_source: shipengine"]},". In the rare case that the label can't be voided automatically, the"," ","message says so. Contact support so you aren't billed for that label."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_billed"]},", or when the field is omitted on a BYOA carrier, duties and taxes problems never stop the label."," ","If the estimate can't be calculated (for example, because of missing customs data), the label is returned without the"," ","estimated duties and taxes."]}]},"headings":[{"value":"Duties and Taxes Payment","id":"duties-and-taxes-payment","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Default When the Field Is Omitted","id":"default-when-the-field-is-omitted","depth":2},{"value":"Which Carriers Support Each Value","id":"which-carriers-support-each-value","depth":2},{"value":"Example","id":"example","depth":2},{"value":"Rates","id":"rates","depth":2},{"value":"Label Errors","id":"label-errors","depth":2}],"frontmatter":{"seo":{"title":"Duties and Taxes Payment"}},"lastModified":"2026-11-06T13:27:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/docs/shipping/duties-and-taxes-payment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}