Landed Cost

Get duty and taxes calculation from an invoice pdf

Get duty and taxes calculation from an invoice pdf

STEP 1

POST https://api.transiteo.io/v1/importFileService/invoicePdf/landedCost

Get a timestamp to request the step 2

Headers

Name	Value
Content-Type	application/json
Authorization	id token from cognito

JSON REQUEST FORMAT

{
  "content": "data:application/pdf;base64,JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PA..."
}

Response

200

{
    "timestamp": 1671483327236
}

400

Incorrect Json (json body request incorrect)

403

1. Max requests exceed
{
    "code": "MAX_REQUESTS_EXCEED",
    "httpCode": 403,
    "name": "ClientError",
    "message": "You've reached the max requests authorized for your account. Please contact our service to upgrade your account",
    "details": [
        {
            "parameter": {
                "name": "UserRequests",
                "value": "${leftCredits}"
            },
            "causes": [
                "Max requests authorized for your account is ${capacity}. Left credits is ${leftCredits}"
            ]
        }
    ]
}

2. TRIAL_LIMIT_EXCEED

{
    "code": "TRIAL_LIMIT_EXCEED",
    "httpCode": 403,
    "name": "ClientError",
    "message": "You have exceeded the trial limit. Please contact our service to upgrade your account",
    "details": [
        {
            "parameter": {
                "name": "UserTrialLimit",
                "value": "${validity} days"
            },
            "causes": [
                "User trial is limited to ${validity} days of usage"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

STEP 2

GET https://api.transiteo.io/v1/importFileService/invoicePdf/landedCost/{timestamp}

Get Duty and Taxes caclulation result

Headers

Name	Value
Content-Type	application/json
Authorization	id token from cognito

Path parameters

Name	Type	Description
timestamp	string	timestamp in millis

Response

200

{
    "dutyCalculationResponse": {
        "products": [
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "6109100010"
                },
                "product_statut": "Authorized for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "9507900000"
                },
                "product_statut": "Restricted for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "9506999000"
                },
                "product_statut": "Restricted for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "6302910090"
                },
                "product_statut": "Authorized for importation into this country",
                "amount_exclusive": 937.5,
                "amount_inclusive_vat": 937.5,
                "amount_duty_and_tax": 0,
                "amount_total": 937.5,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            }
        ],
        "shipping_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "packaging_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "insurance_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "transit_fees_global": null,
        "global": {
            "amount": 0,
            "amount_exclusive": 3931.5,
            "amount_inclusive_vat": 3931.5,
            "amount_total": 3931.5,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": 0
        }
    },
}

401

{
    "message": "The incoming token has expired"
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}