Asycuda World Programmeurhandleiding XML Formaat Bij Aangiften

Transcriptie

1 Asycuda World Programmeurhandleiding XML Formaat Bij Aangiften

2 ASYCUDAWORLD Aangifte XML formaat Onderwerp aangifte XML bericht specificatie Versie 2011\1 Datum van xxxxxxxxxxx opmaak Doel: Dit document heeft als doel het beschrijven van de xml formaat voor Aangifte Samenhangend document: gebruikershandleiding bij aangifte module Voor wie bestemd: XML Bericht Programmeurs Aangifte XML_Specificatie Pagina 1 van 14

3 Inhoud INTRODUCTIE...3 ASYCUDA WORLD AANGIFTE XML BERICHT FORMAAT...3 ALGEMENE OPMERKING...3 DATA STROOM VAN HET ENIG DOCUMENT...3 OMSCHRIJVING VAN HET ENIG DOCUMENT DATA ETIKETTEN...4 ALGEMENE DEEL VAN DE AANGIFTE...5 ARTIKEL DEEL...5 SPECIALE OVERWEGINGEN...5 Aangifte XML_Specificatie Pagina 2 van 14

4 Introductie De United Nations Conference on Trade and Development (UNCTAD) heeft als onderdeel van het ASYCUDA programma, applicaties ontworpen welke de elektronisch data verkeer tussen douane en het bedrijfsleven mogelijk maakt. In dit document zal men een uitgelegd worden te geven hoe aangevers een aangifte in xml formaat op elektronische wijze kan indienen. ASYCUDA World Aangifte XML Bericht Formaat Algemene Opmerking De aangifte gegevens ( Enig Document ) van ASYCUDA WORLD kunnen direct van de cliënt gebruikers applicatie in een XML formaat geëxporteerd - of geïmporteerd. Binnen de subopties van het gedetailleerde aangifte e-document klik je op het icoontje [ icoontje [ ] Export XML bestand Data stroom van het Enig Document De structuur van het XML bericht bestaat uit twee grote onderdelen: De algemene deel van de aangifte <SAD> De gedetailleerde gegevens voor elk artikel van de aangifte <Items> ] Import XML bestand of op het De algemene deel is samengesteld uit de navolgende subonderdelen ( zie bijlage Algemene deel van de aangifte ): 1. Aangifte identificatie: <Identification> 2. Informatie m.b.t. tot de handelaars: <Traders>. Dit sub-onderdeel is weer onderverdeeld in drie (3) nadere onderdelen: a. Informatie m.b.t. de exporteur/verschipper: <Exporteur> b. Informatie m.b.t. de geconsigneerde/importeur: <Consignee> c. Informatie m.b.t. Financiële afwikkeling <Financial> 3. Aangever deel: <Declarant> 4. Algemene informatie deel: <General_information> 5. Informatie m.b.t. het Transport: <Transport> 6. Financiële informatie: <Financial> 7. Informatie m.b.t. de opslagplaats: <Warehouse> 8. Vervoer informatie (voor vervoer aangiften): <Transit> 9. Informatie m.b.t. berekening notitie: <Valuation> 10. Informatie m.b.t. de containers: <Containers> 11. Laadlijst informatie (voor vervoersaangiften ): <Loading_list> Het artikel deel is als volgt samengesteld (Zie Artikel deel ) Aangifte XML_Specificatie Pagina 3 van 14

5 1. Verpakking informatie: <Packages> 2. Tarief informatie: <Tariff>. Dit onderdeel is weder onderverdeeld in volgende onderdelen a. G.S codering: <Harmonized_system> b. Aanvullende eenheden: <Supplementary_unit> c. Quota informatie: <Quota> 3. Goederen omschrijving: <Goods_description> 4. Artikel berekening notitie: <Valuation_item> 5. Aangehechte bescheiden: <Attached_documents> 6. Omschrijving van voorafgaand document: <Previous_document> 7. Additionele informatie deel: <Additional_information> De XML dient informatie te bevatten van slechts een (1) aangifte. Het kan maximaal 99 artikelen bevatten. Bij export aangiften zal het soms nodig zijn meerdere informatie te verschaffen. Deze extra elementen zijn informatieve aard en worden bij een invoer aangifte niet mee genomen Omschrijving van het Enig Document data etiketten De tabellen in deze sectie bevat informatie over elk etiket inclusief het formaat, het gebruik ( verplicht of facultatief ). Gelieve rekening mee te houden dat het gebruik van een etiket ( verplicht of facultatief ) onafhankelijk is van het aangifte model. De meeste elementen zijn facultatief en hun gebruik is afhankelijk van de wijze hoe elk aangifte soort is geconfigureerd. Het gespecificeerde formaat van elk etiket kan van een het volgende type zijn; het nummer (#) symbool dient vervangen te worden door gewenste lengte. Format Definition Examples INT Integer nummer maximaal 18 digits N# Decimal nummer maximaal 18 digits inclusief decimal plaatsen and punt. N5 =>10.00 N5 =>4789 N8 => AN# Alphanumeric string. AN1 =>C AN35 =>JOHN DOE DATUM Date format yyyy-mm-dd TIJD Time format hh:mm:ss 12:30:00 BOOLEAN Twee mogelijke waarden: True false Aangifte XML_Specificatie Pagina 4 van 14

6 Algemene Deel van de Aangifte SEGMENT: <Sad> / < Identification > <Manifest_reference_number> AN28 Facultatief Manifest referentie nummer. Het is opgebouwd uit twee of componenten (spaties): Douanekantoor (Facultatief) Manifest referentie Jaar (Verplicht) Manifest reference nummer (Verplicht) < Total_number_of_packages> N6 Verplicht Totaal aantal colli van de alle artikelen van de aangifte SEGMENT: <Sad> / <Identification > / < Office_segment> <Customs_clearance_office_code> AN5 Verplicht CribNo. Douane kantoor waar aangifte wordt gedaan. <Customs_clearance_office_name> AN35 Verplicht Naam Douane kantoor alwaar aangifte wordt gedaan. SEGMENT: <Sad> / < Identification > / < Type > < Type_of_declaration > AN3 Verplicht Soort aangifte < General_procedure_code > N1 Verplicht Algemene Aangifte procedure code < Type_of_transit_document > INT Facultatief SEGMENT: <Sad> / <Traders> / < Exporter > <Exporter_code> AN17 Facultatief CribNo. van Exporteur code <Exporter_name> AN175 Facultatief Naam en adres van de Exporteur SEGMENT: <Sad> / <Traders> / < Consignee > < Consignee_code > AN17 Facultatief CribNo. van Consigneerde < Consignee_name > AN175 Facultatief Naam en adres van de Consigneerde SEGMENT: <Sad> / <Traders> / < Financial> Aangifte XML_Specificatie Pagina 5 van 14

7 <Financial_code> AN17 Facultatief CribNo. van Instantie verantwoordelijk voor financiële afwikkeling <Financial_name> AN175 Facultatief Naam en adres van Instantie verantwoordelijk voor financiële afwikkeling SEGMENT: <Sad> / < Declarant > <Declarant_code> AN17 Facultatief CribNo. Aangever <Declarant_name> AN175 Verplicht Naam en adres Aangever <Declarant_representative> AN35 Facultatief Naam vertegenwoordiger van aangever SEGMENT: <Sad> / < Declarant > / < Reference> <Number> AN17 Facultatief Aangever referentienummer SEGMENT: <Sad> / < General_information> <Value_details> N15 Facultatief Waarde gegevens <CAP> AN5 Facultatief <Comments_free_text> AN7000 Facultatief Vrije Text veld SEGMENT: <Sad> / < General_information> / < Country> <Country_first_destination> AN3 Facultatief Code Land eerste bestemming / Land van herkomst <Trading_country> AN3 Facultatief Code handelsland SEGMENT: <Sad> / < General_information> / < Country> / < Export> <Export_country_code> AN3 Facultatief Code land van export <Export_country_name> AN35 Facultatief Naam Land van export <Export_country_region> AN4 Facultatief Code regio land van export SEGMENT: <Sad> / < General_information> / < Country> / <Destination> <Destination_country_code> AN3 Facultatief Code Land van Bestemming <Destination_country_name> AN35 Facultatief Naam Land van Bestemming <Destination_country_region> AN4 Facultatief Code region land van bestemming Aangifte XML_Specificatie Pagina 6 van 14

8 ELEMENT: <Sad> / <Transport> <Container_flag> BOOLEAN Facultatief Indicatie of de goederen geladen zijn in container <Location_of_goods> AN17 Facultatief Code Locatie van de goederen ELEMENT: <Sad> / <Transport> / <Means_of_transport> <Inland_mode_of_transport> AN3 Facultatief Code Binnenlands vervoerswijze ELEMENT: <Sad>/ <Transport>/<Means_of_transport>/ <Departure_arrival_information> <Identity> AN27 Facultatief Identiteit van vervoermiddel bij vertrek/aankomst <Nationality> AN3 Facultatief Nationaliteit van vervoermiddel bij aankomst/vertrek(landcode) ELEMENT: <Sad> / <Transport> / <Means_of_transport> / <Border_information> <Identity> AN27 Facultatief Identiteit van vervoermiddel bij vertrek/aankomst <Nationality> AN3 Facultatief Nationaliteit van vervoermiddel bij aankomst/vertrek(landcode) <Mode> AN3 Facultatief Code vervoerswijze ELEMENT: <Sad> / <Transport> / <Delivery_terms> <Code> AN3 Facultatief Code levering conditie <Place> AN28 Facultatief Plaats van levering <Situation> AN2 Facultatief Code situatie levering conditie ELEMENT: <Sad> / <Transport> / <Border_office> <Code> AN5 Facultatief Code Douanekantoor <Name> AN35 Facultatief Naam Douanekantoor ELEMENT: <Sad> / <Transport> / <Place_of_loading> <Code> AN5 Facultatief Code plaats van laden/lossen <Name> AN35 Facultatief Naam plaats van laden/lossen <Country> AN3 Facultatief Landcode plaats van laden/lossen ELEMENT: <Sad> / <Financial> <Deffered_payment_reference> AN17 Facultatief Rekeninghoudersnummer Aangifte XML_Specificatie Pagina 7 van 14

9 ELEMENT: <Sad> / <Financial> / <Financial_transaction> <Code_1> N1 Facultatief Aard van transaktie, code 1 <Code_2> N1 Facultatief Aard van transaktie, code 2 ELEMENT: <Sad> / <Financial> / <Bank> <Code> AN17 Facultatief Bank code <Name > AN35 Facultatief Bank naam <Branch> AN17 Facultatief Bank branch code <Reference> AN35 Facultatief Bank filial nummer (referentie) ELEMENT: <Sad> / <Financial> / <Terms> <Code> AN3 Facultatief Code Betaling voorwaarde <Description > AN35 Facultatief Omschrijving Betaling voorwaarde ELEMENT: <Sad> / <Financial> / <Amounts> <Code> AN3 Facultatief Code Betaling voorwaarde <Description > AN35 Facultatief Omschrijving Betaling voorwaarde ELEMENT: <Sad> / <Financial> / <Guarantee> <Name> AN17 Facultatief Code Garantie referentie ELEMENT: <Sad> / <Warehouse> <Identification> AN17 Facultatief Identificatie van opslagplaats (code) <Delay> INT Facultatief Opslagtermijn (days) ELEMENT: <Sad> / <Transit> / <Principal> <Code> AN17 Facultatief CribNo. Verantwoordelijke voor vervoer <Name > INT Facultatief Naam Verantwoordelijke voor vervoer <Representative> AN100 Facultatief vertegenwoordiger Verantwoordelijke voor vervoer ELEMENT: <Sad> / <Transit> / <Signature> <Place> AN17 Facultatief Plaats van vervoer Aangifte XML_Specificatie Pagina 8 van 14

10 <Date> DATE Facultatief Date of signature of transit ELEMENT: <Sad> / <Transit> / <Destination> <Office> AN17 Facultatief Code Douanekantoor van bestemming bij vervoer <Country> DATE Facultatief Datun van vervoer ELEMENT: <Sad> / <Valuation> <Calculation_working_mode> N1 Verplicht Werkwijze, mogelijke waarde: 0 : Verdeling naar waarde 1 : Verdeling naar gewicht 2 : Geen verdeling, Berekend totaal ELEMENT: <Sad> / <Valuation> / <Weight> <Gross_weight> N17 Facultatief Totale bruto gewicht van aangifte ELEMENT: <Sad> / <Valuation> / <Invoice> TAG NAME FORMAT USE DESCRIPTION <Amount_foreign_currency> N15 Verplicht Faktuurwwarde in vreemde valuta <Currency_code> AN3 Verplicht Code vreemde valuta ELEMENT: <Sad> / <Valuation> / <External_freight> <Amount_foreign_currency> N15 Facultatief Bedrag aan externe vrachtkosten in vreemde valuta <Currency_code> AN3 Facultatief Code vreemde valuta externe vracht ELEMENT: <Sad> / <Valuation> / <Internal_freight> <Amount_foreign_currency> N15 Facultatief Bedrag aan interne vrachtkosten in vreemde valuta <Currency_code> AN3 Facultatief Code vreemde valuta interne vracht ELEMENT: <Sad> / <Valuation> / <Insurance> <Amount_foreign_currency> N15 Facultatief verzkereingskosten in vreemde valuta <Currency_code> AN3 Facultatief Code vreemde valuta verzekering kosten Aangifte XML_Specificatie Pagina 9 van 14

11 ELEMENT: <Sad> / <Valuation> / <Other_cost> <Amount_foreign_currency> N15 Facultatief Bedrag in vreemde valuta <Currency_code> AN3 Facultatief Code vreemde in valuta ELEMENT: <Sad> / <Valuation> / <Deduction> <Amount_foreign_currency> N15 Facultatief Bedrag in vreemde valuta <Currency_code> AN3 Facultatief Code vreemde in valuta ELEMENT: <Sad> / <Containers> / <Container > <Item_number> INT Facultatief Artikelnummer behorende bij de container <Container_identity> AN17 Facultatief Container identificatie code <Container_type> AN4 Facultatief Container type code <Empty_full_indicator> AN3 Facultatief vol/leeg indicatie code <Gross_weight> N12 Facultatief Bruto gewicht van container <Goods_description> AN35 Facultatief Goederen omschrijving <Packages_type> AN17 Facultatief Code soort verpakking <Packages_number> N6 Facultatief Aantal colli <Packages_weight> N12 Facultatief Gewicht ELEMENT: <Sad> / <Loading_list> / <Line> <Item_number> INT Facultatief Artikelnummer behorende bij de container <Vehicle> AN17 Facultatief VIN_nummer Vehicle Number (Identification) <Container> AN17 Facultatief Container identificatie code <Packaging_code> AN17 Facultatief Code soort verpakking <Packaging_description> AN35 Facultatief Package type name <Packages> N6 Facultatief Aantal colli <Goods_description> AN35 Facultatief Goederen omschrijving <Gross_weight> N12 Facultatief Bruto gewicht Aangifte XML_Specificatie Pagina 10 van 14

12 Artikel Deel ELEMENT: <Items> / <Item> / <Packages> <Number_of_packages> N6 Optional aantal colli <Marks1_of_packages> AN35 Optional Merk en nummers 1 <Marks2_of_packages> AN35 Optional Merk en nummers 2 <Kind_of_packages_code> AN17 Optional Code soort verpakking <Kind_of_packages_name> AN35 Optional Naam soort verpakking ELEMENT: <Items> / <Item> / <Tariff> <Extended_customs_procedure> N4 Mandatory procedure code (vier cijfer) <National_customs_procedure> N3 Optional Nationale aangifte procedure code (drie cijfer) <Preference_code> AN17 Optional Preferentie code <Valuation_method_code> AN1 Optional Code wijze van berekening ELEMENT: <Items> / <Item> / < Tariff > / <Harmonized_system> <Commodity_code> N8 Mandatory GS code ( acht cijfer) <Precision_1> N3 Optional GS, national precisie #1 <Precision_2> N4 Optional GS, national precisie #2 <Precision_3> N4 Optional GS, national precisie #3 <Precision_4> AN4 Optional GS, national precisie #4 ELEMENT: <Items> / <Item> / < Tariff > / <Supplementary_unit> <Supplementary_unit_code> AN3 Optional Code aanvullende eenheid <Supplementary_unit_name> AN35 Optional Naam aanvullende eenheid <Supplementary_unit_quantity> N11 Optional Hoeveelheid aanvullende eenheid ELEMENT: <Items> / <Item> / < Tariff > / <Quota> <Quota_code> AN17 Optional Quota referentie code ELEMENT: <Items> / <Item> / <Goods_description> <Country_of_origin_code> AN3 Mandatory Code land van oorsprong <Country_of_origin_region> AN4 Optional Code regio land van oorsprong <Description_of_goods> AN88 Optional Goederen omschrijving <Commercial_description> AN44 Optional Handels omschrijving Aangifte XML_Specificatie Pagina 11 van 14

13 ELEMENT: <Items> / <Item> / <Valuation_item> <Rate_of_adjustment> AN3 Optional Waarde aanpassing ELEMENT: <Items> / <Item> / <Valuation_item> / <Weight > ETIKET NAAM FORMAAT GEBRUIK DESCRIPTION <Gross_weight_itm> N12 Optional Bruto Gewicht (kg) <Net_weight_itm> N12 Optional Netto Gewicht (kg) ELEMENT: <Items> / <Item> / <Valuation_item> / <Invoice> <Amount_foreign_currency> N15 Mandatory Faktuurwaarde in vreemde valuta y <Currency_code> AN3 Mandatory Code vreemde valuta van faktuur ELEMENT: <Items> / <Item> / <Valuation_item> / <External_freight> <Amount_foreign_currency> N15 Mandatory Bedrag aan buitenlandse vracht in vreemde valuta <Currency_code> AN3 Mandatory Code vreemde valuta van buitenlandse vracht ELEMENT: <Items> / <Item> / <Valuation_item> / <Internal_freight> <Amount_foreign_currency> N15 Mandatory Bedrag aan binnelandse vracht in vreemde valuta <Currency_code> AN3 Mandatory Code vreemde valuta van binnenlandse vracht ELEMENT: <Items> / <Item> / <Valuation_item> / <Insurance> <Amount_foreign_currency> N15 Mandatory Bedrag aan verzekering in vreemde valuta <Currency_code> AN3 Mandatory Code vreemde valuta verzekering ELEMENT: <Items> / <Item> / <Valuation_item> / <Other_cost> <Amount_foreign_currency> N15 Mandatory Bedrag aan andere kosten in vreemde valuta <Currency_code> AN3 Mandatory Code vreemde valuta andere kosten ELEMENT: <Items> / <Item> / <Valuation_item> / <Deduction> <Amount_foreign_currency> N15 Mandatory Bedrag te verminderen in vreemde valuta <Currency_code> AN3 Mandatory Code vreemde valuta te verminderen Aangifte XML_Specificatie Pagina 12 van 14

14 ELEMENT: <Items> / <Item> / <Attached_documents> / <Attached_document> <Attached_document_code> AN4 Optional Code aangehechte document <Attached_document_name> AN70 Optional Naam aangehechte document <Attached_document_reference> AN30 Optional Referentie aangehechte document <Attached_document_date> DATE Optional Datum aangehechte document ELEMENT: <Items> / <Item> / <Previous_document> <Summary_declaration> AN26 Optional Summiere aangifte (Vervoers document nummer <Summary_declaration_sl> AN4 Optional Vervoers document nummer, sub-lijn <Previous_document_reference> AN35 Optional Voorafgaand document referentie <Previous_warehouse_code> AN17 Optional Voorafgaand code opslagplaats ELEMENT: <Items> / <Item> / <Additional_information> <Licence_number> N6 Optional Vergunning nummer <Amount_deducted_from_licence> N15 Optional waarde bedrag in mindering gebracht op vergunning <Quantity_deducted_from_licence> N15 Optional Hoeveelheid in mindering gebracht op vergunning <Free_text_1> AN35 Optional Gereserveerde veld <Free_text_2> AN20 Optional Gereserveerde veld Speciale overwegingen 1. In some cases, data may be unavailable when constructing the XML message. If Treasury Department does not define that information as mandatory, the user can omit those tags. 2. In sommige gevallen zijn de gegevens niet aanwezig bij het opstellen van het XML bericht. Indien dat informatie niet als een verplicht veld is aangemerkt kan dat betreffende etiket achterwege blijven. Aangifte XML_Specificatie Pagina 13 van 14