H7 Declaration (Akanea)

Get XML File to import in AKANEA Customs software from an invoice

Get XML File to import in AKANEA Customs software from an invoice

STEP 1

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

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/h7Declaration/{timestamp}

Get export invoice 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

<CustomsH7DeclarationMessage>
    <Header>
        <CustomsHeader>
            <DecHeader>
                <DecLrn>TNICOLASB1718491591353</DecLrn>
            </DecHeader>
        </CustomsHeader>
        <InternalHeader>
            <DatTimMsg>2024-06-15T22:46:31</DatTimMsg>
            <UsrGroupe>TRANSITEO</UsrGroupe>
            <UsrCode>TRANSITEO_DEMO</UsrCode>
            <DecSchemaIntern>1</DecSchemaIntern>
            <DecAppId>H7T</DecAppId>
            <DecRefintdos>2022-02-11</DecRefintdos>
            <CusActCod>1</CusActCod>
            <IntActCod>0</IntActCod>
        </InternalHeader>
    </Header>
    <Declaration>
        <DecTypDec>CO</DecTypDec>
        <DecAddDecTyp>A</DecAddDecTyp>
        <DecAgrNum>12341234</DecAgrNum>
        <DecDeclOffice>FRA12345</DecDeclOffice>
        <DecPresOffice>FRA12345</DecPresOffice>
        <DecLocGds>STORE WAREHOUSE</DecLocGds>
        <DecGroMass>120</DecGroMass>
        <DecImporter>
            <DecImpName>Ma compagnie</DecImpName>
            <DecImpCountry>FRA</DecImpCountry>
            <DecImpPostcode>65000</DecImpPostcode>
            <DecImpCity>Tarbes</DecImpCity>
            <DecImpStreet>Rue du maréchal Foch</DecImpStreet>
        </DecImporter>
        <DecExporter>
            <DecExpName>Ma compagnie</DecExpName>
            <DecExpCountry>FRA</DecExpCountry>
            <DecExpPostcode>65000</DecExpPostcode>
            <DecExpCity>Tarbes</DecExpCity>
            <DecExpStreet>Rue du maréchal Foch</DecExpStreet>
        </DecExporter>
        <DecRepresentative>
            <DecRepStatus>1</DecRepStatus>
            <DecRepConName>NICOLAS BERTUOL</DecRepConName>
            <DecRepConPhone>[phone]</DecRepConPhone>
            <DecRepConEmail>[e-mail]</DecRepConEmail>
        </DecRepresentative>
        <DecDeclarant>
            <DecDecName>Ma compagnie</DecDecName>
            <DecDecCountry>FRA</DecDecCountry>
            <DecDecPostcode>65000</DecDecPostcode>
            <DecDecCity>Tarbes</DecDecCity>
            <DecDecStreet>Rue du maréchal Foch</DecDecStreet>
            <DecDecConName>NICOLAS BERTUOL</DecDecConName>
            <DecDecConPhone>[phone]</DecDecConPhone>
            <DecDecConEmail>[e-mail]</DecDecConEmail>
        </DecDeclarant>
        <GoodsList>
            <Goods>
                <GdsIteNum>1</GdsIteNum>
                <GdsAddProc1>F48</GdsAddProc1>
                <GdsNbPackages>1</GdsNbPackages>
                <GdsDescription>Smartphone</GdsDescription>
                <GdsNomenc>8517130000</GdsNomenc>
                <GdsIntrValue>14400</GdsIntrValue>
                <GdsIntrValueCur>EUR</GdsIntrValueCur>
                <GdsTrspCost>0</GdsTrspCost>
                <GdsTrspCostCur>EUR</GdsTrspCostCur>
                <GdsGroMass>120</GdsGroMass>
            </Goods>
        </GoodsList>
    </Declaration>
    <requestType>1</requestType>
</CustomsH7DeclarationMessage>

401

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

500

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