Home
Interfaces
Contents
1. Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalNotificationImportSchema gt EAIManual0071117 doc 66 Interface IMCHN ImportChangeNotification Direction Import Purpose Submit changes on an Animal a Facility a Sanitary Unit or even a Party Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx o ImportChangeNotification Input Schema ChangeNotificationlmport E E hangeMotiFicationImpart ChangeNotificationImport E ChangeNotification ChangeNotificationi A User string A SecurityToken string 3 ara ia a da iride da la cla A A PP RARR aa CLR e e to TUTTO TTL TT E m m rm rm m m m rm rm rm rm m rmm rm MOTP CDE HOED CDE OCR DTE RCV DTE REF HBR DOC HER ANTP CDE AMTP CDE ALT PATY CDE FCLT ELE 2NUN CCE AMML CDE MORS CDE ROS CMN Change string string dateTime dateTime string string string string string string string string string string change HY Lie A EE EE a E ATRB CDE string E VAL OLD string E VAL MEW string http Sanitrace EAI SanitraceRepository SanitraceServices ChangeNotificationImportSchema XML Example s Change of hair type lt
2. Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc lt CDE gt BE40141489 lt CDE gt lt SNUN_CDE gt BE40141489 0101 lt SNUN_CDE gt SE lt Animal gt lt REF_NBR gt BE48600665 lt REF_NBR gt lt MACT_CDE gt BE lt MACT_CDE gt lt MRK_NBR gt 48600665 lt MRK_NBR gt lt ANML_REF_NBR_MHR gt DE 0346949849 3 lt ANML_REF_NBR_MHR gt lt ANSB_CDE gt BOV lt ANSB_CDE gt lt ANRT_CDE gt MILK lt ANRT_CDE gt lt ASRV_CDE gt LIV lt ASRV_CDE gt lt GNDR_CDE gt MAL lt GNDR_CDE gt lt HRTP_CDE gt R lt HRTP_CDE gt SB3TE_DTE gt 2008 10 26T00 00 00 lt BTE DIES lt DTH_DTE gt 2008 10 26T00 00 00 lt DTH_DTE gt lt PPPU_CDE gt NRM lt PPPU_CDE gt lt VRV_FLG gt t rue lt VRV_FLG gt lt VRV_IDN_CRD_FLG gt t rue lt VRV_IDN_CRD_FLG gt lt ABFY_CDE gt MLK lt ABFY_CDE gt lt ADSP_CDE gt EASY lt ADSP_CDE gt lt ANCP_CDE gt NRM lt ANCP_CDE gt lt NRS_MHR_FLG gt true lt NRS_MHR_F LG gt lt ANVS_CDE gt PREM lt ANVS_CDE gt lt BTH_WGH gt 25 lt BTH_WGH gt lt DNA_SMP_FLG gt false lt DNA_SMP_FLG gt lt MLT_BTH_FLG gt true lt MLT_BTH_FLG gt lt RCE_PUR_FLG gt false lt RCE_PUR_FLG gt lt Animal gt lt AnimalNotification gt lt AnimalNotificationImport gt Import Notification
3. E SNUN_CDE E NAM E REF NER E EXT REF NBR E ANTP CDE E ANSB CDE BAG E SUKD CDE E FCLT CDE E FCLT NAM E AL1 E AL2 E STR E NBR E BOX E ZIP E CTY E MCP E CTRY CDE E RSP CDE E RSP NAM E RSP REF NER E RSP EXT REF NMBR E pap ALI E RSP AL2 E RSP STR E RSP NBR E RSP BOX E RSP ZIP E RSP CTY E RSP MCP E RSP_CTRY_CDE E WaterManureAnimalAllocation string dateTime dateTime string string string string string string string string string string string string string string string string string string string string string string string string string string string string string string string WaterManureAnimalAllocation JE SiwaterManureAnimalAllocation WaterManureAnimalAllocation E ANM CDE E FRM DTE E TO DTE E VATP CDE E AATP CDE string dateTime dateTime string string It is out of the scope of this document to discuss how to calculate Water Manure information based on this information Please consult the dedicated Water and Manure calculations user manual Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 63 Interface ImportAnimalNotification Direction Import Purpose Submit births or import records Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportAnimalNotification Input Schema AnimalNotificationlmport MPTP CDE CDE string
4. lt AnimalNotificationImport User TESTXML SecurityToken N A lt AnimalNotification gt lt NOTP_CDE gt ARIMO lt NOTP_CDE gt lt OCR_DTE gt 2008 11 17T12 00 00 lt OCR_DTE gt lt REF_NBR gt XXX123 lt REF_NBR gt lt DOC_NBR gt YYY456 lt DOC_NBR gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt lt CRF_NBR gt FR20080077995 lt CRF_NBR gt LC ILIABCI23 IL1C BL CTRY CDE FRMPFR CTRY CDE FRM gt Party lt NPTP_CDE gt DLR lt NPTP_CDE gt lt CDE gt BE12500104 lt CDE gt lt Party gt aca aig lt NFTP_CDE gt SRC lt NFTP_CDE gt lt CDE gt BE40070824 lt CDE gt lt SNUN_CDE gt BE40070824 0150 lt SNUN_CDE gt EES IN EE lt Animal gt lt MACT_CDE gt FR lt MACT_CDE gt lt MRK_NBR gt 5940143152 lt MRK_NBR gt lt ANML_REF_NBR_MHR gt FR5940183831 lt ANML_REF_NBR_MHR gt lt ANSB_CDE gt VCALF lt ANSB_CDE gt lt ANRT_CDE gt MILK lt ANRT_CDE gt lt GNDR_CDE gt FEM lt GNDR_CDE gt lt HRTP_CDE gt BLW lt HRTP_CDE gt lt PPPU_CDE gt NRM lt PPPU_CDE gt lt PRUN_REF_NBR gt 4602500153 lt PRUN_REF_NBR gt lt SBTE_DT2 gt 2007 01 01T00300300 lt BTE_ DIES SERIES DIE gt 2008 11 17T00 00 00 lt IMO DTES lt CRF_NBR gt FR20080077995 lt CRF_NBR gt lt CTRY_CDE_IMO gt FR lt CTRY_CDE_IMO gt lt Animal gt lt AnimalNotification gt lt AnimalNotificationImport gt
5. lt OISN_CDE gt BOVSL lt OISN_CDE gt User SecurityToken ReturnCode ReturnMessage MarkingSeries string string string string unseres MarkingSeries m mmm mm mm mm mm mm mm mm m ANTP_CDE SEQ BEG SEQ END MACT CDE MARK NBR CNT SNUN CDE NAM STR NBR ZIP CTY MCP ALC DTE UPD DTE OISN CDE OITP CDE OILB CDE string string string string string string string string string string string string string dateTime dateTime string string string http Sanitrace EAI SanitraceRepository SanitraceServices ExportMarkingSeriesOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 59 Interface EXRNO ExportRetaggingNotificationOverview Direction Export Purpose Export Retagging Notification Overview Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ExportRetaggingNotificationOverview Input Schema RetaggingNotificationOverviewExportRequest E NOTF ID long E NOTP CDE string E MRezggingNotficationOverviewbxportReguest RetaggingNotificationOverviewExportRequest E i i Sege BR string E Ret Notificat Ret Notificat etaggingNotification reg otification E OCR DTE FRM PIECE A User string n E OCR_DTE_TO dateTime A SecurityToken string E REF_NBR string A Resultindex int H E PATY CDE tri strin A OnBehalfRole string z 9 A OnBehalfEntit strin SOLO Tn Li y eg 9 E S
6. OnBehalfEntity The entity you are working on behalf of This typically will be a Facility or a Sanitary Unit However the functionality might be extended to parties to We have currently only updated the schema s for movements and birth imports And we will not re display all XSD schema s but the picture underneath shows how the OnBehalf information 1s added in the root element of an XML A User strinq A Security Token string A OnBehalfRole string A OnBehalfEntity string A UserLanguage string If you are working on behalf of always add the tokens They might be non functional now but will become functional soon Localized Error Messages As seen in the above structure there 1s also an attribute called UserLanguage This attribute has to be set with every message call The allowed languages are EN English NL Dutch FR French DE German The interaction result or exception messges are than localized in the specified language Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 92 Interfaces Technical Usage Web Application The online application can be accessed via e http qas sanitrace be web QAS Sanitrace Web Pages Common Default aspx In principle you should log in with your user name and then navigate to the Upload XML page Select an XML submit it and save or open the result XML It is a good practice to study the application online behavior before you start using the
7. lt MovementNotificationImport User string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema gt lt MovementNotification gt lt NOTP_CDE gt MMDPR lt NOTP_CDE gt lt OCR DER 200e Ol TO 2 4 OCE Din lt REF_NBR gt lt REF_NBR gt lt DOC_NBR gt lt DOC_NBR gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 3 lt ANM_CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt lt CRF_NBR gt lt CRF_NBR gt lt LIC_PLT gt KMJ496 lt LIC_PLT gt lt CMN gt string lt CMN gt SEGEEby lt NPTP_CDE gt RSP lt NPTP_CDE gt SGDESEET254567 0 CDE lt Party gt spam lt NPTP_CDE gt TRA lt NPTP_CDE gt lt CDE gt BE56781234 lt CDE gt lt Party gt lt sFacilicy gt lt NFTP_CDE gt SRC lt NFTP_CDE gt ep EIE c 1 65 lt DOE Sanitrace EAI Manual Draft v 1 5 SecurityToken string EAIManual0071117 doc 74 lt FALO_REF_NBR gt string lt FALO REF_NBR gt lt SNUN_CDE gt string lt SNUN_CDE gt lt Paci ity lt Animal gt lt REF_NBR gt BE34534534 lt REF_NBR gt PpPI VERS NEE 5 PET VERS NER lt Animal gt lt Animal gt lt REF_NBR gt BE34534536 33100456576 lt REF_NBR gt lt Animal gt lt Animal gt lt REF_NBR gt BE34534537 33100456576 lt REF_NBR gt lt Animal gt lt MovementNotification gt lt MovementNotificationImport gt Arrival animals on a Market lt xml wem si MO lt MovementNotificationImport xmlns xsi http www w3 0r
8. Draft v 1 5 EAIManual0071117 doc 102 Web Service Security The Web Services are until now only secured using the XML web services user account and password And this account 1s shared by all XML users Furthermore we do not intend to introduce https for the web services both for performance reasons and stability reasons Especially in web services high frequent https connectivity can cause problems Additionally we do not expect people to strongly authenticate them using X509 certificates as this 1s probably overkill for this application All XML users have to specify their User account in the message This account is used for treating the XML this sharing of the same connection is on itself not a problem This user account is linked to the Party and Facility for whom the XML requests are being done e g an arrival a change notification and security and business rules are validated against this user account Read The XML is processed against the rights of this user In addition this user account 1s also used in the audit trail Now the attentive reader has detected two possible security issues What if a hacker sniffs the message and resubmits it possibly with other information What if you specify a user name you should not use Let s ignore the first one and focus on the second one Indeed theoretically people having access to XML messaging and knowing accounts of other users could submit an XML as if they were that us
9. MCP Municipality Sanitrace EAI Manual Draft v 1 5 ZIP Postal Code EAIManual0071117 doc 17 Coding Schema s Content The following 1s a list of accepted returned user codes Codes can be recognized as lt USERGOUP gt _CDE e g ADSP_CDE AGEC CDE Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc AATP Animal Allocation Type System created animal allocation System created overruling animal allocation ABFY Beefiness 0 Milkcalf LBFY 1 Low Beefiness 2 Normal Beefiness ADPR Animal Departure Reason Ouderdom Age 04 Overtollig Surnum raire Afgemest Slachtrijp Fini pret abattre Been Klauwaandoening Affection d un membre 10 ou de l onglon Voedingsstoornissen Trouble alimentaire Problemen rond het afkalven Probl me de 12 v lage 14 Vruchtbaarheid Fertilit LH aa nee Slecht exterieur Mauvais ext rieur NEN Gedrag Comportement ADSP AnimalDeliverySpecifics Easily Normal Difficult CSRN oawed Off TE Other Aid AGEC AgeCategory Younger than 18 months SHP GOAT DEER GE18 18 Months or Older SHP GOAT DEEH LT6 Younger than 6 months BOV Between 6 and 12 Months BOV Between 12 and 24 Months BOV GE24 24 Months or Older BOV af ME Status ele i om e Re Ere APTP Agreement Party Type CVET Surveillance Veterinary CVETB Backup Surveillance Veterinary EAIManual0071117 doc LNGE Language Dutch French G
10. A ReturnCode A ReturnMessage http Sanitrace EAI SanitraceRepositorv SanitraceServices ChangeNotificationOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 36 Interface EXFAO ExportFacilityOverview Direction Export Purpose Retrieve a general overview of facilities name address infor reference numbers liable party details Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportFacilitvOverview Input Schema FacilityOverviewExportRequest 9 E FATP CDE string CDE string MAM string REF HEF string EXT_REF_MER string STR string ZIP string CTRY CDE string PRLIM REF HER string AMTP CDE string UPD_DTE_FRM dateTime UPD DTE TO dateTime PATY CDE LIA string m E acilityOverviewExportRequest FacilityOverviewExportRequest E Facility Facility A User string A SecurityToken string A Fesultindex int Mm Mm Mm Mm Mm Mm Mm Mm mm mm Mm mMm http Sanitrace EAI SanitraceRepository SanitraceServices FacilityOverviewExportRequestSchema XML Example s Example EXFAO 1 Retrieve all sheep owners in Brugge lt FacilityOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices FacilityOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt He LEES lt FATP_CDE gt FARM lt FATP_CDE gt lt ANTP_CDE gt SHP lt ANTP_CDE gt lt ZIP gt 8000 lt ZIP gt p
11. http Sanitrace EAI SanitraceRepository SanitraceServices AnimalMovementNotificationOverviewExportRequestSch ema XML Example s Example EXAMN 1 Retrieve all movements of a certain animal in a certain period lt AnimalMovementNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalMovementNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt Movement gt lt DTE_FRM gt 2004 01 01T00 00 00 lt DTE_FRM gt DIE 6 2099 O1 O1TOO 00 OO DIE HO lt ANML_REF_NBR gt NL456453543 lt ANML_REF_NBR gt lt Movement gt lt AnimalMovementNotificationOverviewExportRequest gt Example EXAMN 2 All arrivals of bovines to a certain slaughterhouse in a certain period lt AnimalMovementNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalMovementNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 30 lt Movement gt lt DTE_FRM gt 2004 01 20T00 00 00 lt DTE_FRM gt lt DTE_TO gt 2004 01 27T23 59 59 lt DTE TOP lt ANTP_CDE gt BOV lt ANTP_CDE gt lt P Chl EDE BE92700117 HELT EDE lt Movement gt lt AnimalMovementNotificationOverviewExportRequest gt Example EXAMN 3 Retrieve all animal movements by a certain Transporter party over the past week AnimalMovementNotific
12. possibilities obviously do exist Please refer to the appendix for more information on synchronization alternatives Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface Overview For the Sanitrace Renewal a number of formal interfaces have been defined for exchange of information Imports of Movements Export of Notifications etc The list underneath gives an overview of a first set of interfaces Direction Code Name Allows an external application to Retrieve a detailed insight of an animal All S 01 ExportAnimal characteristics risk status history Export Retrieve an overview of movements of a certain Export S 02 EXAMN ExportAnimalMovementNotificationOverview animal from to a certain facility Retrieve an overview of animals and their key Export S 03 EXANO ExportAnimalOverview characteristics Retrieve an overview of changes to a Facility a Export S 04 EXCNO ExportChangeNotificationOverview Sanitary Unit or Animal characteristics Retrieve a general overview of facilities name address infor reference numbers liable party details Export EXFAO Export Export ExportFacilityOverview Retrieve a detailed insight in a movement involved parties involved facilities involved XMVN ExportMovementNotification animals Retrieve an overview of movements of a certain ExportMovementNotificationOverview animal from to a certain facility
13. Be Jee Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 86 Interface IMPMS ImportMarkingSeries Direction Import Purpose Submit marking series allocations Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportMarkingSeries Input Schema MarkingSerieslmport E MAT CDE string AMTP CDE string ALC DTE dateTime SEQ BEG string SEQ END string CHT int m E E MarkingSeries MarkingSeries A User string A SecurityToken string ORIM CDE string MSAL CDE string FCLT CODE string SMUIN CDE string CMN string m Pm mm Pm Pm Pm Pm Pm Pm FA http Sanitrace EAI SanitraceRepository SanitraceServices MarkingSeriesImportSchema XML Example s XML Example 1 Manually allocating earmarks lt 7xmL versions 0 encoding UuLr 3o 2 gt lt MarkingSeriesImport xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MarkingSeriesImportSche ma User string SecurityToken N A gt lt MarkingSeries gt lt MACT_CDE gt BE lt MACT_CDE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SEQ_BEG gt 00001217 lt SEQ_BEG gt lt SEQ END gt 00001218 lt SEQ_ END lt CNT gt 2 lt CNT gt ORIM CDE gt DGZ V POM ULTRA R 001 lt ORIM_ CDE gt lt MSAL_CDE gt AMANU lt MSAL_CDE gt lt SNUN_CDE
14. Channel 2 upload download via secured streaming page SlaughterFile and SlaughterInfo XML files to be imported can be streamed to the following secured page http qas sanitrace be int QAS Sanitrace ExtInterfacingS vcs GenericX MLHandler ashx To access the pages you need to enter the following credentials User XMLASNTRC Password ed5RZCK5 The code underneath gives an example on how to use this secured interface Package Channel 3 upload download via unsecured streaming page XML import files can be streamed to the following page http qas sanitrace be web QAS Sanitrace Web Interfacing GenericXMLHandler ashx The code in scenario 2 can be used Just replace the URL as mentioned above and delete user name and password Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 99 Channel 4 upload download via web page After selecting the menu option Upload XML Or by entering the URL http qas sanitrace be web QAS Sanitrace Web Pages Common Upload XMLPage aspx You get to the manual upload page which is rather straight forward E Process XML File Microsoft Internet Explorer Fi SI Eq File Edit Yiew Favorites Tools Help ae ra E Back iX la Search Favorites C N Sanitel Net Help Co Home Party amp Facility Notification Yisit Risk Agreement Order Marking Slaughtering File To Send Browse Send XML Logout vzx5px NI On this page you can test whet
15. E vaN FLG boolean E PPT VRS HER ink E PPPR CDE string E VRY FLG boolean E ABFY CDE string E ABSP CDE BAG string E ADSP_CDE string E AMCP CDE string E NRS_MHR_FLG boolean E AMPR CDE BAG string E AMOL CDE string E VRY IDN CRD FLG boolean E ANYS CDE string E ANVWN CDE string E VRY HAM string E BTH_WGH decimal E LST_UPD DTE dateTime E DO STA CMM string E IMO DTE dateTime E EPO DTE dateTime E PLUR DTE dateTime E ORI MBR string E CRF MBR string E DNA AMA REF HER string E DNA SMP FLG boolean E DHAG CDE string E AMPP PNT DTE dateTime E ERT DLV DTE dateTime E L5T DLV DTE dateTime E FRT MK DTE dateTime E FRT MUR DTE dateTime http Sanitrace EAI SanitraceRepository SanitraceServices AnimalOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 34 Interface EXCNO ExportChangeNotificationOverview Direction Export Purpose Retrieve an overview of changes to a Facility a Sanitary Unit or Animal characteristics For a description of possible change attributes see ImportChangeNotification Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportC hangeNotificationOverview Input Schema ChangeNotificationOverviewExportRequest E NOTF ID long E NOTP_CDE string E NOKD_CDE string E NOST_CDE string E OCR_DTE_FRM dateTime BFS changeNotificationOverviewExportRequest ChangeNotificationOverviewExportRequest E OCR DTE TO dateTime E Ch
16. For informational purpose these are our standards Strings are by default 50 characters UNLESS They represent User Codes gt Length 5 They represent Descriptions gt Length 255 They represent Comments gt Length 800 They are explicitly constrained to another length for technical reasons An example of this is street in the current interfaces which are constrained to 40 for printing reasons Examples o NAM VARCHAR2 50 CHAR ALI VARCHAR2 50 CHAR AL2 VARCHAR2 50 CHAR STR VARCHAR2 40 CHAR ZIP VARCHAR2 50 CHAR CTY VARCHAR2 50 CHAR MCP VARCHAR2 50 CHAR EMA VARCHAR2 50 CHAR TPH VARCHAR2 50 CHAR TPH_ALT VARCHAR2 50 CHAR GSM VARCHAR2 50 CHAR FAX VARCHAR2 50 CHAR GNDR_CDE VARCHAR2 5 CHAR O O O O O O O O AD c9 soo Slaughtering Module only Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 110 20 Q How do we have to specify animal numbers when using them in the XML and how are these numbers formatted when exported A This 1s a difficult problem so we have tried to come to the best and most informative information for anyone There are different business rules for the validation of Bovine earmark numbers in different countries of the European Union Some countries even have 2 checkdigits For example Belgium Country Code 4 Check Digit 12345678 BE 9 12345678 Germany Country Code 10 chars check digit DE 1234567890 1 UK 6 numbers Check Digit 5 Numbers UK 1234
17. MovementNotification gt lt MovementNotificationImport gt Registering an Export Movement sil version iO o gt lt MovementNotificationImport xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 0org 2001 XMLSchema User TESTXML SecurityToken N A xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema lt MovementNotification gt lt NOTP_CDE gt MMEPO lt NOTP_CDE gt lt OCR_DTE gt 2008 11 05T13 19 28 lt OCR_DTE gt lt DOC_NBR gt INTRA BE 2008 0029632 V1 lt DOC_NBR gt lt CRF_NBR gt BE IC ANT 2008 4023 1995 lt CRF_NBR gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt mne pus Hys EE lt CTRY_CDE_FRM gt NL lt CTRY_CDE_FRM gt Bor lt NPTP_CDE gt TRA lt NPTP_CDE gt DE ET GbE lt Pavey Bat lt NPTP_CDE gt DLR lt NPTP_CDE gt lt CDE gt BE12500104 lt CDE gt Up lt Facility gt lt NFTP_CDE gt SRC lt NFTP_CDE gt lt CDE gt BE12500104 lt CDES lt SNUN _ CDE gt BE12500104 0101 lt SNUN_CDE gt 47 Fae lity lt Facility gt lt NFTP_CDE gt ORI lt NFTP_CDE gt CODE m5 AIDE SSNUNCCODE BETOOST4S57 0g Ops SNUNSCDE lt Pacility gt lt Animal gt lt REF_NBR gt BE117833993 lt REF_NBR gt lt PPT VRS NBR gt 2 lt PPT VRS NBR lt Animal gt lt MovementNotification gt lt MovementNotificationImport gt Output Schema Interaction Result S
18. NBR string EXT REF NBR string 3 ALL string AL2 string vi PLILILILILILIILILILILILEILILILILILILILILITILILILILILILILILIIIINIAA MAP roductienunit ProductionUnit mm mm mm MM m m m m m rm rm mu Marking MACT CDE NBR CDG REF NBR PRWA CDE SUHS CDE PRQU CDE ANSB CDE POP CNT CAG CNT STB CNT SUC BRO History RSP DES VTY DES TUST CDE RIQU CDE RIQR CDE RSK QAL CMN BLST CDE PBRS CDE PBST CDE PPT BLO STA CMN TUBR CDE BLO STA CMN DTE FRM DTE TO PRUN CDE ANSB CDE AGEC CDE MAL CNT FEM CNT TOT CNT http Sanitrace EAI SanitraceRepository SanitraceServices Sanitary UnitExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 52 Interface EXSUO ExportSanitaryUnitOverview Direction Export Purpose Retrieve a general overview of sanitary units and their key characteristics Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ExportSanitary UnitOvervie Input Schema SanitaryUnitOverviewExportRequest 9 E SUTP DE string CDE string MAM string REF WER string EXT REF HER string ZIP String FCLT CDE string PRLIM REF NH string PATY CDE RSP string AMTP CDE string UPD DTE FRI dateTime UPD DTE TO dateTime m E E Sanitarvlinit SanibarvlIniE A User string A SecurityToken string A Resultindex ink E E E E E E E E E E E http Sanitrace EAI SanitraceRepository Sanitrac
19. WNaterManureAllocationi User string VaterManuredllacation WaterManuredllocation SecurityToken string E SMUM CDE string Resultindex int E VER string OnBehalfRole string OnBehalfEntity string UserLanguage string http Sanitrace EAI SanitraceRepository SanitraceServices WaterManureAllocationExportRequest XML Example s Example EXWMA 1 Retrieve the water and manure allocations for a number of sanitary Units lt 2xml version 1 0 encoding fTB 9 lt WaterManureAllocationExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices WaterManureAllocationExportRequestSchema User vzx5px SecurityToken N A gt lt WaterManureAllocation gt SNUNZCDE Er 007262 oie SNUNBCDE lt YER gt 2008 lt YER gt lt WaterManureAllocation gt lt WaterManureAllocation gt lt SNUN_CDE gt BE10097159 0101 lt SNUN_CDE gt lt YER gt 2008 lt ER gt lt WaterManureAllocation gt lt WaterManureAllocationExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 62 Output Schema WaterManureAllocationOverview E aterManureAllocationExport WaterManureAllocationExport E waterManureAllocation A User A SecurityToken A ReturnCode A ReturnMessage http Sanitrace EAT SanitraceRepository SanitraceServices ExportWaterManureAllocationOverviewExportSchema WaterManureAllocation string string string string ESA terManureAllocation WaterManureAllocation
20. back end services In fact a lot of the functionality is very similar Please consider the user manuals discussing the online application general working registering accounts updating your profile registering issues etc To retrieve the manuals click on the InfoCentre link in the top right corner of the application header Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 93 Channel 1 upload download via secured web service The web services can be access via http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx This site 1s secured you need to enter the following credentials User XMLASNTRC Password ed5R CK5 This provides the list of both import and export Web Methods as shown underneath Sanitrace_SanitraceServices Sanitrace Services The following operations are supported For a formal definition please review the Service Description e ExportAnimal e ExportAnimalMovementNotificationOverview e ExportAnimalOverview e ExportChangeNotificationOverview e ExportFacilityOverview e ExportMovementNotification e ExportMovementNotificationOverview ExportPartyOverview e ExportProductionUnitOverview ExportSanitaryUnit ExportSanitaryUnitOverview e Import nimalNotification e ImportChangeNotification e ImportInventoryNotification e ImportMovementNotification e ImportPopulationNotification s ImportProductionUnitNotification e ImportRiskNotification Modern development en
21. lt UPD DTE FRM gt dateTime lt UPD DTE FER All attributes lt UPD DTE TO gt dateTime lt UPD DTE TO lt TRGR CDE stringz TRGH CDE lt fAnimal gt lt fAnimalOverviewExportRecuest gt lt f ExportinimalOrerview gt lt f soap Body z soap Emnvelope Input structure HTTP 1 1 200 OK Content Type text xml charset utf S Content Length length Bond tig longa I OH sica ab go ble EIE te soap Envelope xmlns xsi http www w3 0rc 2001 ENLSchema instance lt soap Body gt lt Export nimaltvervienuResponse xmlns http Sanitrace EAI Sanit lt AnimalOyerviewExport User string SecurityToken strinig He lt Animal gt lt ANTF CDE stringc ANTP CDE lt CDE gt string lt CDE gt lt MACT CDE gt string lt MicT CDE lt MRE CDG gt string lt MRE CDG gt All attributes lt MRE NBR gt string lt MRE HER Output structure Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 95 Another powerful feature of Web Services 1s that one can retrieve the online Web Service Definition in general and all XSD schema s in particular LE http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs SANITRACESERVICES ASM X wsdl The schema names are automatically generated so might get changed when updating the proxy See the table underneath for the active configuration A Schema can be retrieved directly via http qas sanitrace be int QAS Sanitrace ExtInterfacineSves SANITRACESERVICES ASMX schema schemaXX
22. Party Party E MRK VRS NBR string E RetaggingLine RetaggingLine E TWO MRK FLG boolean http Sanitrace EA I SanitraceRepository SanitraceServices RetqggingNotificationImportSchema XML Example s lt xml verste 0 neSdiRNg UEE SU lt RetaggingNotificationImport User TESTXML xmlns http Sanitrace EAI SanitraceRepository SanitraceServices RetaggingNotificationIm portSchema gt lt RetaggingNotification gt lt NOTP_CDE gt RETAG lt NOTP_CDE gt lt NOKD_CDE gt lt NOKD_CDE gt OE DTE gt 2008 09 04T12 3 30 00 lt 0CR_DTE gt lt RCY_DTE gt 2008 09 04T12 3 305s 00 lt RCY DiE lt REF_NBR gt Test_retag lt REF_NBR gt lt DOC NBR 124 DOC NBR lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SEFECLT CDE gt BE60012911 lt FCLTI EDE SNUNSCDE BE00ZO OE SNY ODE lt CMN gt Comment 2 lt CMN gt Sport lt NPTP_CDE gt ORDR lt NPTP_CDE gt CDE 590 07 310 Sis CDE lt Party gt lt Party gt lt NPTP_CDE gt DELV lt NPTP_CDE gt lt CDE gt BE100023073 lt CDE gt lt Party gt lt RetaggingLine gt lt ORIM_CDE gt DGZ V HOM M7 R 001 lt ORIM_CDE gt lt ANML_CDE gt BE60717242 lt ANML_CDE gt lt MRK_VRS_NBR gt 1 lt MRK_VRS_NBR gt TWO MRK FLG falses TWO MRK FLG Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 82 Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 83 Interface IMRSN ImportRiskNotification Di
23. Retrieve a general overview of Parties Name Address Reference Numbers Contact rm 1 1 lt Z Export EXPAO ExportPartyOverview Data Retrieve a general overview of which exploitation Export S 09 EXPUO ExportProductionUnitOverview units are used at which facilities sanitary units Retrieve detailed info about a sanitary unit Location Address Sanitary Characteristics Involved Parties Production Unit Info Marking Inventory Capacity Population Inventory Risk Export S 10 EXSU ExportSanitaryUnit Information History Information Retrieve a general overview of sanitary units and Export S 11 EXSUO ExportSanitary UnitOverview their key characteristics Export EXSLO ExportSlaughteringOverview Retrieve summary statistics of slaughtered animals Import IMANN ImportAnimalNotification Submit births or import records Submit changes on an Animal a Facility a Import S 14 IMCHN ImportChangeNotification Sanitary Unit or even a Party Import INN ImportInventoryNotification Submit marking inventory results Submit water manure consumption statistics Import S 16 IMMWN ImportManureWaterNotification corrections Import MVN ImportMovementNotification Submit a movement e g Mobile App Import PPN ImportPopulationNotification Submit population inventory results Submit assignments of production units Import S 19 IMPUN ImportProductionUnitNotification exploitation units to Sanitary Units Import IMRS
24. Retrieve detail info on the Dutch speaking veterinary with ordernumber 1257 lt LiablePartyOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices LiablePartyOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt LiableParty gt lt VEOR_CDE gt NL lt VEOR_CDE gt lt ORD_NBR gt 1257 lt ORD_NBR gt lt LiableParty gt LiablePartyOverviewExportRequest Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Output Schema LiablePartyOverviewExport E iableParty LiableParty CDE string MAM string HAM LET string HAM FRT string REF_MER string EXT REF MBR string UPD_DTE dateTime ALI string ALZ string STR string HEF string BOX string ZIP string CTY string MCP string CTRY_CDE string LAGE CDE string VER CDE string ORD HEF string EMA string TPH string GSM string FAX string RLM_RGS_NBR string VAT HEF string DNK HEF string LNGE CIE string m E iablePartyOverviewExport LiablePartyOverviewExport E LiableParty LiableParty A User string A Security Token string A Returncade string A ReturnMessage string Pm mmm Pm mm mm Pm MA MA MA MA MA mm Pm Pm Pm mm mm MA Pm Pm http Sanitrace EAI SanitraceRepository SanitraceServices LiablePartyOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXPUO ExportProductionUnitOverview Direction Export Purpose Retrieve a general overview of which expl
25. WGH decimal E ERT DLV DTE dateTime E LST DLV DTE dateTime E FRT MLK DTE dateTime E ERT NUR DTE dateTime E LST UPD DTE dateTime E History History F Rick fRick http Sanitrace EAI SanitraceRepository SanitraceServices AnimalExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXAMN ExportAnimalMovementNotificationOverview Direction Export Purpose Retrieve an overview of movements of individual animals gt from to a certain facility This interface can also be used for herd animals yet will not have any animal details Instead ExportMovementNotificationOverview can be used Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportAnimalMovementNo tificationOverview Input Schema paiement Movement E NOTF ID long E NOTP CDE string E NOKD CDE string E NOST_CDE string E DTE_FRM dateTime nimalMovementNotificationOverviewExportRequest 4nimalMovementNotificationOverviewExportRequest E DTE_TO dateTime E Movement Movement A E REF MBR string A User string E DOC NBR string A SecurityToken string E LIC_PLT string A ReturnCode string E ANTP_CDE string A ReturnMessage string E ANSB_CDE string A OnBehalfRole string E PATY CDE TRS string A OnBehalfEntity string E FCLT CDE string A UserLanguage string s E SNUN_CDE string E ZIP string E ANML REF MER string E UPD DTE FRM dateTime E UPD DTE TO dateTime ki
26. arrivals of pigs to a certain market on a certain day lt MovementNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationOverviewExportReguestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt MovementNotification gt lt NOTP_CDE gt MMARV lt NOTP_CDE gt lt DTE_FRM gt 2007 11 15T00 00 00 lt DTE_FRM gt lt DTE_TO gt 2097 11 15T23 59 59 lt DTE_TO gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 39 Example EXAMN 3 Retrieve all movements by a certain Transporter party over the past week Output Schema J EE 9t E MovementNotificationOverview MovementNotificationOverview A User string A SecurityToken string A ReturnCode string A ReturnMessac string htt Cree EAI SanitraceRe ETE N TE E EEE ETE Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXMVN ExportMovementNotification Direction Export Purpose Retrieve a detailed insight in a movement involved parties involved facilities involved animals Layout Documentation http qas sanitrace be int QAS_Sanitrace_ExtInterfacingS vcs SanitraceServices asmx 0p ExportMovementNotification Input Schema MovementNotificationExportRequest MovementNotificationExportRequest MovementNotificationExportRequest Movement Movement E Movement Movement E ID long A User string A Security Token string http San
27. gt BE70052294 0101 lt SNUN_CDE gt lt CMN gt Test Import lt CMN gt lt MarkingSeries gt lt MarkingSeriesImport gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 87 Interface IMPST ImportStatusUpdateNotification Direction Import Purpose Submit a status update notification currently limited to treatments but extendable to other notifications Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportStatus UpdateNotifica tion Input Schema StatusUpdateNotificationimport CFs statusUpdateNotification StatusUpdateNotification E ttusUpdateNotificationiImport StatusUpdateNotificationimport E NOTF_ID E StatusUpdateNotification StatusUpdateNotification E NOTP CDE string E NOKD CDE string A User string B E A SecurityToken string REF NBR string E WF ACT string http Sanitrace EAI SanitraceRepository SanitraceServices Status UpdateNotificationImportSchema XML Example cancelling a treatment via notification id and versions O encoding EE EE lt StatusUpdateNotificationImport User string SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices StatusUpdateNotificationImportSchema gt lt StatusUpdateNotification gt lt NOTP_CDE gt TMT lt NOTP_CDE gt lt NOTF_ID gt 5006782 lt NOTF_ID gt lt WF_ACT gt CAN lt WF_ACT gt lt StatusUpdateNotification gt lt StatusUpdat
28. string E AL1 string E AL2 string E STR string E NBR string Y E Facility E NFTP_CDE string E CDE string E NAM string E REF_NBR string E EXT_REF_NBR string E FLTP_CDE string E ALI string E AL2 string E STR string E NBR string E BOX string E ZIP string E CTY string E MCP string E CTRY_CDE string E TPH string E SanitaryUnit SanitaryUnit E NotificationLocation NotificationLocation Le E mm Animal E REF_NBR string E EXT_REF_NBR string E BTH_DTE string E HRTP_CDE string E GNDR_CDE string E ANRC_CDE string E ANML_MRK_NBR string E ANRT_CDE string ET SanitaryUnit SUTP_CDE CDE REF_NBR EXT_REF_NBR SUKD_CDE ANSB_CDE_BAG RDC_NBR BLST_CDE mM mm mm m m m string string string string string string string string otificationLocatio NotificationLocati FLTP_CDE REF_NBR EXT_REF_NBR TPH ALI AL2 STR NBR BOX ZIP CTY MCP CTRY_CDE mM mm mm mm MM MM m m EAIManual0071117 doc string string string string string string string string string string string string string 42 Interface EXPAO ExportPartyOverview Direction Export Purpose Retrieve a general overview of Parties Name Address Reference Numbers Contact Data Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportPartvOverview Input Schema PartyOverviewExportRequest m PATP_
29. 0096025 0101 lt SNUN_CDE gt VEL cy lt Animal gt lt ANML_REF_NBR_MHR gt BE43281842 lt ANMI_ REF_NBR_MHR gt lt ANSB_CDE gt BOV lt ANSB_CDE gt ETE BOE Oe MM 2 9100 s 00 s 00 lt BTH JS BITS s DTER_DTE gt 2008 10 29T00500 00 lt DTE DTE lt PPPU_CDE gt NO lt PPPU_CDE gt lt VRV_FLG gt false lt VRV_FLG gt lt VRV_IDN_CRD_FLG gt false lt VRV_IDN_CRD_FLG gt lt NRS_MHR_FLG gt true lt NRS_MHR_FLG gt lt ANVS_CDE gt NONE lt ANVS_CDE gt lt BTH WGH gt 0 lt BTH WGH gt lt DNA_SMP_FLG gt false lt DNA_SMP_FLG gt lt MLT_BTH_FLG gt false lt MLT_BTH_FLG gt lt RCE_PUR_FLG gt false lt RCE_PUR_FLG gt lt Animal gt lt AnimalNotification gt lt AnimalNotificationImport gt Dead born calf notification marked lt AnimalNotificationImport User TESTXML SecurityToken N A xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalNotificationImportSchema gt lt AnimalNotification gt lt NOTP_CDE gt ARBTH lt NOTP_CDE gt lt RCV_DTE gt 0001 01 01T00 00 00 lt RCV_DTE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt DDMKD lt ANCO_CDE gt lt Party gt NEU PICUE BOE NPIP EDE lt CDE gt BE402979302 lt CDE gt lt Party gt lt Pacillicy gt lt NFTP_CDE gt DST lt NFTP_CDE gt
30. 02607960 lt REF_NBR gt Upon rt lt ProductionUnitOverviewExportRequest gt Example 3 Retrieve the info about all production units changed over a certain period lt ProductionUnitOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc ProductionUnitOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt BeodueelonUnie lt UPD_DTE_FRM gt 2007 11 11T00 00 00 lt UPD_DTE_FRM gt lt UPD_ DTE Ho 007 CI EE EE DE lt Production nit gt lt ProductionUnitOverviewExportRequest gt Output Schema ProductionUnitOverviewExport ProductionUnit ProductionUnit E REF_NBR string E PRC_REF_NBR string E PRC NAM string E PRC STR string E PRC NBR string E PRC ZIP string E PRC CT string E SUTP CDE string E SNUN CDE string E SNUN NAM string E SNUN REF NBR string E FCLT CDE string E FCLT NAM string E FCLT REF NBR string E FLTP CDE string E FALO REF NBR string ProductionUnitOverviewExport ProductionUnit verviewExport E AL1 string E ProductionUnit ProductionUnit E AL2 string A User string E STR string A SecurityToken string E NBR string A ReturnCode string E E BOX string A ReturnMessage string E ZIP string E CTY string E MCP string E CTRY_CDE string E TPH string E LIA CDE string E LIA NAM string E LIA REF NBR string E LIA EXT REF NBR string E LIA ALI string E LIA AL s
31. 5 Interface EXAGR ExportAgreementOverview nennen enne 56 Interface EXMS ExportMarkingSerieSOvervieW ee ee ee ee ee ee ee ee ee Ee 58 Interface EXRNO ExportRetaggingNotificationOverview ees esse ese ee ee ee ee ee ee 60 Interface EX WMA ExportWaterManureAllocation iese sesse ee ee ee se ee ee ee ee ee ee ee 62 Interface ImpotrtAummialNoUHCaOT v uoo EE Ie ha RS ei 64 Interface IMCHN ImportChangeNotification ee ee Re ee EE 67 Interface IMINN ImportInventory Notification ee ee ee ee ee ee Ee 71 Interface IMMWN ImportManureWaterNotification esse sees ee EE 73 Interface IMMVN ImportMovementNotification ss 74 Interface IMPPN ImportPopulationNotification essere 79 Interface IMPUN ImportProductionUnitNotification ee EE SI Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface IMRTN ImportRetaggingNotification i 82 Interface IMRSN ImportRiskNotification ss 84 Interface IMTMN ImportTreatmentNotification i 85 Interface IMPMS ImportMarkingsSerles nnne enne nnn 87 Interface IMPST Import Ulpodatehopfcapon ee EE 88 See definition Interaction Result Schema 89 InteracionResult acari 90 Workin On Ben EE 92 Locahzed Error Messages ratti 92 TACT ACES Technical EE 93 KE
32. 538067 lt xml yersion 1 0 2 lt InteractionResult xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 0rg 2001 XMLSchema gt lt StatusCode gt Success lt StatusCode gt lt Summary gt Import ImportChangeNotificationUseCase successfull Change Notification Importing 2522 545453 ChangeNotification information is imported lt Summary gt lt Reference gt 868538067 lt Reference gt lt Details gt lt InteractionResult gt In case of incorrect URLs you receive an interaction result like shown underneath Important is the StatusCode Error a Summary Message and one or more Detail Message Entries lt xml equa nce lt InteractionResult xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 0rg 2001 XMLSchema gt StatusCode Erwor lt 7 Stakuccode lt Summary gt Import ImportChangeNotificationUseCase erroneous Change Notification Importing 2522 345453 ChangeNotification information is Noe amporeed See logs Pot Mone a nos mis En lt Summary gt lt Reference gt lt Details gt lt Messagennt iry lt Code gt 266 lt Code gt lt Description gt Record not found in table Table ANIMAL for search criterium Country MarkingNumber with value BE 00004461 lt Description gt lt Pattern gt Record nee mound in table 10 for search criterium TU wich value 12 lt Pattern gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 90 lt ArgumentsCSV
33. 56 7 89012 France 10 Characters no check digits AT 563291834 AT 720505211 BE 7 92242112 BE 2 92243756 DE 0534520976 6 DE 0768 86240 1 DE 0768 86241 8 DE 0768847064 3 DE 0768954849 5 FR 0200920637 HU 302142046 0 HU 302142055 4 IT 023000369118 IT 023000369120 NL 34035029 0 NL 34507600 5 NL 42217978 4 BE4013 971 0101 BE4013 971 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE50087431 0101 BE50087431 0101 BE10173416 0101 BE10173416 0101 BE10082933 0101 BE10082933 0101 BE10082933 0101 NL 49036299 6 UK 340933 7 00835 UK 343334 6 01345 SK 800414521 SK 800414627 SK 800510542 SK 800511834 DE 1082378273 0 LU 7 98640685 PL 00513852014 7 IE 1814236 5 0661 CZ 102104591 CZ 102104594 ES 8 0301551380 ES 4 0302762403 FR 5511800004 FR 5613882371 BE10082933 0101 BE10082933 0101 BE10082933 0101 BE10119225 0101 BE10119225 0101 BE10119225 0101 BE10119225 0101 BE101 3416 0101 BE101 3416 0101 BE101 3416 0101 BE10111021 0101 BE30041613 0101 BE30041613 0101 BE30041613 0101 BE30041613 0101 BE30041613 0101 BE30041613 0101 Every country has its own rules however in every country old animal numbers exist that do not conform with the last version of the rules In addition the migrated data contains quite some incorrectly specified foreign numbers or incorrect missing checkdigits For example lin Belgium th
34. BR gt lt DOC_NBR gt string lt DOC_NBR gt lt ANTP_CDE gt string lt ANTP_CDE gt lt ANTP_CDE_ALT gt string lt ANTP_CDE_ALT gt lt HCHINCDE string ECLI EDE lt SNUN_CDE gt string lt SNUN_CDE gt lt CMN gt string lt CMN gt SORA IE lt NPTP_CDE gt string lt NPTP_CDE gt lt CDE gt string lt CDE gt lt Party gt Suc lt NPTP_CDE gt string lt NPTP_CDE gt lt CDE gt string lt CDE gt lt Party gt lt Populationcount gt lt ANSB_CDE gt string lt ANSB_CDE gt lt PRWA_CDE gt string lt PRWA_CDE gt SSUHISSeDB string Sume lt PRQU_CDE gt string lt PROU_CDE gt lt POP_CNT gt decimal lt POP_CNT gt lt PopulationCount gt SEI M cues ome GN lt ANSB_CDE gt string lt ANSB_CDE gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 80 Interface IMPUN ImportProductionUnitNotification Direction Import Purpose Submit assignments of production units exploitation units to Sanitary Units Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportP roductionUnitNotification Input Schema ProductionUnitNotificationlmport DP roductionunitnotification ProductionUnitNotification DIEF ioon ProductionUnit E NOTP_CDE string E PRUN_REF_NER string DP oductionnitnotificationImport fProd
35. C injection IDINJ ID injection IM injection IN injection IV injection IMMIJ IMM injection IPINJ ORALF Pour on methode Bolus Wash spray dip INFUS Infuus vochttherapie TUBR BlockingReason SANR Sanitary Reason ADMIN Adminstrative Reason UNTRC Untraceable TUST TrackingUnitStatus Sanitary Units Stopped TUST TrackingUnitStatus Animals Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 25 INV Bovine is in Sanitary Unit Inventory Bovine moved from Sanitary Unit Pp read Bovine arrived in Sanitary Unit other federation Bov arrived in SanitaryUnit awaiting purchase AWAI exam Bovine has arrived in new Sanitary Unit RJCT Purchase has been rejected in new Sanitary Unit DDSLH _ Bovine is dead Slaughterhouse Bovine has been exported Bovine is dead Meat Production Bovine blocked due to sale fr Facility H status UNIT Unit Codes KG G MG L DL L DL DE C ML DOSIS G SET 4 Tubes VATP VLMAnimalType Mestkalveren Meskaveren oo Melde MLKCW Melkkoe SCLCW Zoogkoe OTBOV Andere runderen VEOR Veterinary Order Dutch Speaking Veterinary Order French Speaking Veterinary Order L Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 26 Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 24 Interface Definition The archive underneath contains a more detailed description for the interfaces For each interface we list it s d
36. CDE string CDE string MAT string REF_NER string EXT REF MBFR string STR string ZIP string CTRY CDE string VOT HER string TPH string RLM_RGS_NER string UPD_DTE_FRM dateTime UPD_DTE_TO dateTime E ParbyoverviewExzporktRequest PartyOverviewExportRequesh E Party A User A Security Token A ResultIndex m Mm mm Mm MM Mm Mm mm m rmm rm rm http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportRequestSchema XML Example s Example EXPA 1 Retrieve transporter Wuyts or Wuits or whatever WU lt PartyOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt RENE lt PATP CDE gt TRS lt PATP CDE gt lt NAM gt WU lt NAM gt lt Party gt lt PartyOverviewExportRequest gt Example EXPA 2 Retrieve all Slaughterhouses lt xml version 1 0 encoding utf 8 gt lt PartyOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportRequestSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 43 User TESTXML SecurityToken N A ResultIndex 0 gt SParey lt PATP_CDE gt SLGHS lt PATP_CDE gt lt Party gt lt PartyOverviewExportRequest gt Output Schema PartyOverviewExport http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportSchema E PartyOverviewe port
37. ChangeNotificationimport User string Securityloken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ChangeNotificationImportSchema gt lt ChangeNotification gt lt NOTP_CDE gt CHANM lt NOTP_CDE gt lt NOKD_CDE gt lt NOKD_CDE gt SOCR DTE gt 2007 11 16T23 10 00 lt 0OCR_DTE gt SREP ONBR 2322 34 34537 1 lt REF ONBR gt DOE BE 2522 34545 Ape NIS lt ANML_CDE gt BE12345678 lt ANML_CDE gt NORS EDE NORSSCDE lt ROS_CMN gt some comment RQS CMN Change lt ATRB_CDE gt HRTP lt ATRB_CDE gt lt VAL_NEW gt BW lt VAL_NEW gt lt Change gt lt Change gt lt ATRB_CDE gt GNDR_CDE lt ATRB_CDE gt lt VAL_NEW gt OX lt VAL_NEW gt lt Change gt lt ChangeNotification gt lt ChangeNorci fication Tmoort gt Output Schema Interaction Result Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 67 See definition Interaction Result Schema CHANM ChangeAnimal CHSNU ChangeSanitaryUnit CHFCY ChangeFacility CHPTY ChangeParty Possible Values for ATRB_CDE as defined today It is still not clear whether all discussed attributes will also be in the final release as sometimes there might be organizational or juridical reasons for not doing it see items in italic E g an animal can not have it s earmark changed yet ANID attributes suggest this possibility The goal is to make this mechanism of attribute changes more or less configur
38. E NOTF ID long E NOTP CDE string E NOKD CDE string E NOST CDE string E OCR DTE dateTime E REF NBR string E ANTP CDE string E PATY CDE string E FCLT CDE string E SNUN CDE string E ANML CDE string E ORIM CDE string E OITP CDE string E OILB CDE string E MRK VRS NBR string EX 3IesggingNotificationOverviewExport RetaggingNotificationOverviewExport E TWO MRK FLG boolean E RetaggingNotification RetaggingNotification E PATY CDE DLV string A User string E PATY CDE FAC string A SecurityToken string H E NAM string A ReturnCode string E STR string A ReturnMessage string E NBR string E ZIP string E CTY string E MCP string E NAM DLV string E STR DLV string E NBR DLV string E ZIP DLV string E CTY DLV string E MCP DLV string E NAM FAC string E STR FAC string E NBR FAC string E ZIP FAC string E CTY FAC string E MCP FAC string http Sanitrace EAI SanitraceRepository SanitraceServices ExportRetaggingNotificationOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXWMA ExportWaterManureAllocation Direction Export Purpose Export Water Manure Allocation so that Water and Manure production Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportWaterManureAllocati on Input Schema WaterManureAllocationOverviewExportRequest E aterManuredllocationExportRequest WaterManureallocationExportRequest E waterManureAllocation
39. E hee EE 93 Channel 1 upload download via secured web service ee ee EE 94 Channel 2 0 d ia edile di ai alieni 98 Channel 2 upload download via secured streaming page ee ee 99 Channel 3 upload download via unsecured streaming page 99 Channel 4 upload download via web page 100 NS BOME EE E Ee N EE RO EE OE EO OE 101 URLS UDMA aiar 101 The D xemboutb BE 101 MOyrhg to Produch Nesser E EOE 102 W CO EE 103 Prequently Asked Quest ONS es SG aaa 107 SUPPO eurn METTE 113 Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Instructions to test the interfaces Introduction XML and Web Services The goal of web services 1s to allow external applications exchange data with the Sanitrace Net application in a standardized efficient and transparent manner The data 1s formatted as XML and the interaction is in two ways Information can be imported in the Sanitrace Net application e g birth notifications movements and information can be exported retrieved from the Sanitrace Net application Sanitrace Net provides three channels for exchanging XML Formal SOAP 1 web services XML Streaming and manual XML uploads The Web Services are meant to complement other usage of the Sanitrace Net application like online access reports etc The web services are in principle not meant to synchronize databases although some
40. EF_NBR gt lt DOC_NBR gt string lt DOC_NBR gt ANT P EDE string ANTS EDE lt ANTP_CDE_ALT gt string lt ANTP_CDE_ALT gt lt FCLT_CDE gt string lt FCLT_CDE gt lt SNUN_CDE gt string lt SNUN_CDE gt lt CMN gt string lt CMN gt SEEN ME EP Eb string IE DE lt CDE gt string lt CDE gt lt Party gt doc lt NPTP_CDE gt string lt NPTP_CDE gt lt CDE gt string lt CDE gt lt Party gt lt Marking gt lt MACT_CDE gt string lt MACT_CDE gt lt NBR gt string lt NBR gt lt CDG gt string lt CDG gt lt REF_NBR gt string lt REF_NBR gt lt CNT gt decimal lt CNT gt lt Marking gt lt Marking gt lt MACT_CDE gt string lt MACT_CDE gt lt NBR gt string lt NBR gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 71 Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 72 Interface IMMWN ImportManureWaterNotification Direction Import or Export or both Purpose Submit water manure consumption statistics corrections Retrieve calculated water manure consumption statistics Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ImportManureW aterNotific ation Input Schema ManureWaterNotificationimport http Sanitrace EAI SanitraceRepository SanitraceServices ManureWaterNotificationImportSchema XML Example s Output Schem
41. L lt GNDR_CDE gt lt HRTP_CDE gt WR lt HRTP_CDE gt mue DYEes2008 10 303009 53100200 1m 1 DIES lt PPPU_CDE gt URG lt PPPU_CDE gt lt VRV_FLG gt t rue lt VRV_FLG gt lt VRV_IDN_CRD_FLG gt t rue lt VRV_IDN_CRD_FLG gt lt ABFY_CDE gt LBFY lt ABFY_CDE gt lt ADSP_CDE gt EASY lt ADSP_CDE gt lt ANCP_CDE gt NRM lt ANCP_CDE gt lt NRS_MHR_FLG gt true lt NRS_MHR_FLG gt lt ANVS_CDE gt NONE lt ANVS_CDE gt lt BTH_WGH gt 23 lt BTH_WGH gt lt DNA_SMP_FLG gt false lt DNA_SMP_FLG gt lt MLT_BTH_FLG gt false lt MLT_BTH_FLG gt lt RCE_PUR_FLG gt false lt RCE_PUR_FLG gt Animal AnimalNotification lt AnimalNotificationImport gt Dead born calf notification not marked lt AnimalNotificationImport User TESTXML SecurityToken N A xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalNotificationImportSchema gt lt AnimalNotification gt lt NOTP_CDE gt ARBTH lt NOTP_CDE gt lt RCV_DTE gt 0001 01 01T00 00 00 lt RCV_DTE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt DDNOT lt ANCO_CDE gt lt Party gt lt NPTP_CDE gt RSP lt NPTP_CDE gt lt CDE gt BE400223090 lt CDE gt lt Party gt lt Pacilicy gt lt NFTP_CDE gt DST lt NFTP_CDE gt lt CDE gt BE40096025 lt CDE gt lt SNUN_CDE gt BE4
42. LIC PLT gt ABC123 lt LIC_PLT gt lt CMN gt lt CMN gt Pose SNEP ODEA DIRES NENE ODER lt CDE gt BE102294097 lt CDE gt lt Party gt SEE lt NPTP_CDE gt TRA lt NPTP_CDE gt lt CDE gt BE102294097 lt CDE gt SEA lt Fac licty gt lt NFTP_CDE gt DST lt NFTP_CDE gt lt CDE gt BE92600104 lt CDE gt ae ay lt Animal gt lt REF_NBR gt BE19158588 lt REF_NBR gt lt PPT_VRS_NBR gt 3 lt PPT_VRS_NBR gt lt Animal gt lt Animal gt lt REF_NBR gt BE19669813 lt REF_NBR gt lt PPT_VRS_NBR gt 2 lt PPT_VRS_NBR gt lt Animal gt lt Animal gt lt REF_NBR gt BE19669812 lt REF_NBR gt lt PPT_VRS_NBR gt 2 lt PPT_VRS_NBR gt lt Animal gt lt Animal gt lt REF_NBR gt BE19669805 lt REF_NBR gt lt PPT_VRS_NBR gt 2 lt PPT_VRS_NBR gt lt Animal gt lt Animal gt lt REF_NBR gt BE19669806 lt REF_NBR gt lt PPT_VRS_NBR gt 2 lt PPT_VRS_NBR gt Animal Animal lt REF_NBR gt BE19669812 lt REF_NBR gt lt PPT_VRS_NBR gt 2 lt PPT_VRS_NBR gt lt Animal gt lt MovementNotification gt lt MovementNotificationImport gt Departure to a slaughterhouse with slaughter vignette number sm version PO lt MovementNotificationImport xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 0rg 2001 XMLSchema User TESTXML SecurityToken N A OnBehalfRole 0 OnBehalfEntity 0 xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImpo
43. MAGY MovementArrivalAgency Retagging PRNT Reprint MT Treatment RGPOP RegisterPopulation RGWAT RegisterWater RGMAN RegisterManure RGORD RegisterOrder NFTP NotificationFacilityType RC Source ne Participating EAIManual0071117 doc 22 PPPU Passport Print Urgency Printing not urgent Printing urgent No printing Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 23 PRQU Production Quality STD Standard Biological Facility e E RJ ITO REN PVL1 PVL001 Belki PVL2 PVL002 Hendrix PVL3 PVL003 Quartes PVLOO4 PVL007 PVLOOS PVLO09 PVL010 Mechelse Koekoek PVL11 PVL011 Coprobel PVL12 PVL012 Val Dieu PVLO13 P Hesbaye PVL014 Coprosain PVLO15 Coq Ard PVLO16 PRWA Production Ware Meat production Artificial insemination Goat Meat production CELAY Consumption eggs lay establishment Hatching egg reproduction lay Hatching egg selection lay maw I Breed lay BRL Breed reproduction lay BRM BSL Breed selection lay BSM Breed selection meat GAME Game set out FISH Fish meat HNY PUTP ProductionUnitType Stage EAT MByafihu raft v 1 5 RIIT RiskltemType Disease EAIManual0071117 doc 24 TITP Treatment Item Type VACI 1st Vaccination VAC2 2nd Vaccination VACLT Last Vaccination Repeated Vaccination Prime Vaccination Treatment Aftercare TMLV Treatment Level Group INV Individual TMTP Treatment Type S
44. N ImportRiskNotification Submit risk notifications laboratory results en Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 8 Import Import Export Import Export Import Export Export Export Export aug N I t ale lt e z mn ImportTreatmentNotification Submit a treatment Submit a status update notification currently n u u o ja ro D IN D IN JN a gt Ww N N IMRSN limited to treatments but extendable to other ImportStatusUpdateNotification notifications To test if certain parties have certain active ExportA greementOverview agreements with certain other parties ImportRetaggingNotification To import a retagging notification To export information about veterinaries and other liable parties This interface has limited access ExportLiableParty Overview only because of privacy concerns ImportMarkingSeries Submit a marking series allocation ExportMarkingSeriesOverview ExportRetaggingNotificationOverview IMPST EXAGR IMRTN XLPO To retrieve an overview of Marking Series Marking Series Allocations To retrieve an overview of Retagging Notifications S 26 XMSO EXRNO To retrieve all Animal allocations to any old or current production unit of a certain facility S 28 EXPU including the from and the to of these allocations To retrieve all Water ManureAnimalAllocations to do a correct calculation of Water Manure consumption Exp
45. NA REF NBR DNA SMP FLG DNAQ CDE VRV_FLG ABFY_CDE ABSP_CDE_BAG ADSP_CDE ANCP_CDE NRS_MHR_FLG ANPR_CDE_BAG AMQL_CDE VRV_IDN_CRD_FLG ANVS_CDE ANVN_CDE VRV_NAM BTH_WGH FRT_DLV_DTE LST_DLV_DTE FRT_MLK_DTE FRT_NUR_DTE ALI AL2 STR NBR BOX ZIP CTY MCP Animal Race Gender Hairtype Code External Group Number External Subgroup Number Production Reference Number Import Date Export Date Facility Code Of Birth Facility Code Of End Local Certificate of Facility of Birth International Certificate of Facility of Birth Country Code Import Country Code Export Animal D n a Analysis Flag Animal D n a Analysis Reference Number Animal D n a Sample Flag D n a Quality Code VRV tracked animal Beefiness Birth Specifics Fase of Delivery Conception Nurture By Mother Flag Premium Codes AnimalMeatQualityLabel Identification Card Flag Verification Specification Name Code Name Birth Weight First delivery date Date when animal gave first birth Last delivery date Date when animal gave last birth First Milk date Date when animal gave first milk First Nursuring date Date when animal gave first milk to a calf Address Line 1 Address Line 2 Street Number Box Zip City Municipal EAIManual0071117 doc 69 NEW New Sanitrace EAI Manual Draft v 1 5 CTRY CDE TPH PATP CDE RLM REG NBR NEW SNUN ANTP NEW SNUN NEW SNUN DES PATY CDE RSP Country Telephone Request for New Pa
46. NFTP_CDE CDE FALO_REF_NBR SNUN_CDE Animal REF_NBR string nimalNotification KAnimalNotification MACT CDE string E NOTP_CDE string MRK NBR string E NOKD_CDE string ANML REF NBR MHR string E OCR DTE dateTime ANML REF NER MHR GTC string E RCV DTE dateTime ANSB CDE string E REF NER string ANRC CDE string LA Za nimalWotificationImport KAnimalNotificationImport E DOC NBR string ANRT CDE string E vTY CDE string E AnimalNotification AnimalMotification E ANTP CDE string ASRY CDE string VTY NAM string A User string E ANM CNT int GNDR_CDE string RSP_CDE string A SecurityToken string E ANCO_CDE string HRTP_CDE string RSP_NAM string aie BTH_DTE dateTime RSP_STR string g i IMO DTE dateTime RSP_NBR string E CTRY_CDE_FRM string DTH_DTE dateTime RSP_ZIP string E CTRY_CDE_TO string ANDT_CDE string RSP_CTY string sty eee PRUN REF NER string RSP MCP string 2 EXT GRP MER string RSP CTRY CDE string E Facility Facility EXT_SGP_NBR string BLST_CDE string E Animal Animal ORI NER string BLO STA CMN string CRF NBR string PPPU_CDE string CTRY CDE IMO string VRV FLG string VRY IDN CRD FLG string ABFY CDE string ABSP CDE BAG string ADSP CDE string ANCP CDE string MRS MHR FLG string AMPR CDE BAG string AMOL CDE string ANVS_CDE string ANVM CDE string VRY_NAM string BTH WGH string DNA SMP FLG boolean MLT BTH FLG boolean RCE DUR FLG boolean History History RIQU_CDE string RIQR_CDE string RSK_QAL_CMN string
47. NUN_CDE string serLanguage strin 3 E ANML_CDE string E DTE FRM dateTime E DTE TO dateTime http Sanitrace EAI SanitraceRepository SanitraceServices ExportRetaggingNotificationOverviewExportRequestSche ma XML Example s Example EXRNO 1 Retrieve all retaggings of the last 3 days lt RetaggingNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices RetaggingNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A gt lt RetaggingNotification gt lt NOTP_CDE gt RETAG lt NOTP_CDE gt lt OCR DTE FRM gt 2008 10 26T00 91019 097 XE des m DTE e ESI a OORDE ME OOS di KEE lt RetaggingNotification gt lt RetaggingNotificationOverviewExportRequest gt Example EXRNO 2 Retrieve all retags a certain sanitary unit did in the last year RetaggingNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices RetaggingNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A gt lt RetaggingNotification gt lt NOTP_CDE gt RETAG lt NOTP_CDE gt OCR DTE _FPRM gt 20089 01 01T00 oe TOO AOT dee IE ede EIS lt OCR DTE_TO gt 2008 10 29T00 00 00 lt OCR_DTE_TO gt lt SNUN_CDE gt BE40078272 0101 lt SNUN_CDE gt RetaggimgNobibicarion lt RetaggingNotificationOverviewExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Output Schema RetaggingNotificationOverviewExport
48. PPT_VRS_NBR string PPR_CDE string PBST_CDE string PBRS_CDE string PPT BLO STA CMM string TUST CDE string TUBR_CDE string DTE_FRM dateTime mmmmmmmmmmmmmmmmmmmmmnmnm E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E http Sanitrace EAI SanitraceRepository SanitraceServices AnimalNotificationImportSchema XML Example s Birth Notification lt AnimalNotificationImport User TESTXML SecurityToken N A xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalNotificationImportSchema lt AnimalNotification gt lt NOTP_CDE gt ARBTH lt NOTP_CDE gt lt RCV_DTE gt 0001 01 01T00 00 00 lt RCV_DTE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt SIP eue y NPTP CDE RSP NPTP CDE lt CDE gt BE400004313 lt CDE gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc lt Party gt aca abge lt NFTP_CDE gt DST lt NFTP_CDE gt lt CDE gt BE40006931 lt CDE gt lt SNUN_CDE gt BE40006931 0101 lt SNUN_CDE gt SEER IE lt Animal gt lt REF_NBR gt BE43332498 lt REF_NBR gt lt MACT_CDE gt BE lt MACT_CDE gt lt MRK_NBR gt 43332498 lt MRK_NBR gt lt ANML_REF_NBR_MHR gt BE43033242 lt ANML_REF_NBR_MHR gt lt ANSB_CDE gt BOV lt ANSB_CDE gt lt ANRT_CDE gt MILK lt ANRT_CDE gt lt ASRV_CDE gt LIV lt ASRV_CDE gt lt GNDR_CDE gt MA
49. PartyOverviewExport E Party Party A User string A SecurityToken string A ReturnCode string A ReturnMessage string Sanitrace EAI Manual Draft v 1 5 m m Mm Mm mm mm mmm mm mmm Mm Mm MM Mm Mm CDE MAM REF_MBR EXT REF MER LIPD DTE ALi LE STR MER BOX ZIP CTY MCP CTRY CDE TPH LNGE CDE string string string string dateTime string string string string string string string string string string string EAIManual0071117 doc 44 Interface EXLPO ExportLiablePartyOverview Direction Export Purpose Retrieves a detailed overview of Liable Party information including sensitive information such as names GSMs phone numbers Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportLiablePartvOverview Input Schema LiablePartyOverviewExportRequest E PATP_COE string CDE string NAM string REF_MER string EXT REF MBF string STR string ZIP string CTRY CDE string VAT HER string TFH string RLM_RGS_MBR string VEOR_CDE string ORD_NER string LIPD DTE FRIM dateTime UPD DIE TO dateTime m E jablePartyOverviewExportRequest LiableParbyCOverviewE xporktRequest E LiableParty LiableParty A User string A SecurityToken string A ResultIndex ink Pm Pm mm mmm mmm mm Pm m http Sanitrace EAI SanitraceRepository SanitraceServices LiablePartyOverviewExportRequestSchema XML Example s Example EXPA 1
50. R CDE string E BLO STA CMN string E ANSB CDE SH E E ANRC_CDE string E vTY CDE string E ANRT CDE string E VTY NAM string E ASRV CDE string E RSP CDE string E GNDR CDE string E RSP NAM string E HRTP CDE string E RSP STR string E BTH DTE dateTime E RSP NER string E IMO DTE dateTime E RSP ZIP string E EPO_DTE dateTime E RSP CTY string E PUR DTE dateTime E RSP MCP string E DTH DTE dateTime E RSP_CTRY_CDE string E PRUN_REF_NBR string E BLST CDE string E EXT_GRP_NBR string E BLO STA CMN string E EXT SGP NER string E RIQU CDE string E FCLT CDE BTH string E RIOR_CDE string E FCLT_CDE_END string E RSK QAL CMN string E E ORI NBR zu E PPT VRS NER string E Animal E CRF NBR string E PPR CDE string AT Ee E CTRY CDE IMO string E PBST CDE string A SecurityToken string E CTRY CDE EPO re E PPT BLO DIES n A ReturnCode string E DNA ANA FLG Wees E PERS CDE string A ReturnMessage string E IDNA_ANA_REF_NBR SEN E TUST_CDE Su E DNA_SMP_FLG boolean E TUBR CDE string DIO DE amg E DTE_FRM dateTime E ler or T E E PRU REF NBR string RS i E PRC REF NER string E PPPR_CDE string E SNUN_CDE string E ANPP PNT DTE dateTime E YRY_FLG boolean E VRY IND CRD FLG boolean E ABFY CDE string E ABSP CDE BAG string sing E ADSP CDE string LIE ering E ANCP_CDE string RIST_CDE string E NRS_MHR_FLG boolean PIECE E ANPR_CDE_BAG string GIE de m E AMQL CDE BAG string Sa Srna E VRY IDN CRD FLG boolean E ANVS CDE string E ANVN CDE string E YRV_NAM string E BTH
51. Sanitrace Sanitrace Belgie Sanitrace Belgique 5anitrace Belgien Sanitrace Luxembourgh Sanitrace Luxemburg Sanitrace Letzeburg Copyright 2000 2007 FAV AFSCA All Rights Reserved EAI USER MANUAL Version 1 23 Feb 16 2009 Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Document History Change Log 1 0 Aug 20 2007 Minimal Version Movements interface only as part of the Proof of Concept for connecting a Mobile Application to the Sanitrace EAI Services 1 1 Oct 9 2007 Initial full Setup draft version for discussion and basic implementation based on Slaughtering Structure Interfaces definition table Nov 3 2007 Initial Design Discussions VRV ALV Internal Nov 16 2007 Major part of documentation Added some initial examples a lot of examples still missing either completely or sometimes just missing the namespace definitions Nov 17 2007 Coding Examples Dec 15 2007 Feedback Error Handling Jan 8 2008 Non Official copy to some users 1 7 Jan 24 2008 Feedback Extra examples Added ExportMovementNotificationOverview documentation Update for new EEC Trasys guideline Feb 15 2008 Change Import 1 9 Mar 15 2008 FAQ extended Important Change Animal Numbers in Export Interfaces from now on contain the check digit To make them clearly visible the checkdigits are surrounded by spaces E g BE 9 52395189 New fields in Export Sanitary UnitOverviewReque
52. TP_CDE string E Agreement Agreement E AGSA CDE string A User string E APTP_CDE string A SecurityToken string de E PATY_CDE string A Resultindex int E FCLT CDE string E SNUN CDE string E DTE dateTime E BEG DTE FRM dateTime E BEG DTE TO dateTime E EMD DTE FRM dateTime E END DTE TO dateTime http Sanitrace EAI SanitraceRepository SanitraceServices ExportA greementOverviewExportRequestSchema XML Example s Example EXAGR 1 Retrieve all agreements of a certain party lt AgreementOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AgreementOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt EE lt SNUN_CDE gt BE10014458 0101 lt SNUN_CDE gt lt Agreement gt lt AgreementOverviewExportRequest gt Example EXAGR2 Has a certain sanitary unit a Read Agreement contract with VRV on Aug 16 lt AgreementOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AgreementOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt AGTEEMEME gt lt AGTP_CDE gt RAFI lt AGTP_CDE gt lt SNUNSCDE BE l0 0 385504101 SNUN EDE PAN ODE SEA 200L 2 PA EDE lt APTP_CDE gt AVPA lt APTP_CDE gt lt DTE gt 2008 08 18T00 s 00 00 lt DTE gt lt Agreement gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Example EXAGR3 Who are the responsible Veterinaries for a number of Sanitary Un
53. The following abbreviations have been used ID Identification MCP Municipality TO AgreementComment MHR Mother AL1 Adress Line 1 MLK Milk AL2 Adress Line 2 MRK Marking ALT Alternate NAM Name Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc ANA ANM BAG BLO BNK BOX BRO BTH CAG CDE CDG CMN CNT CRD CRF CTY DES DLV DNA DOC DST DTE DTH EMA END EPO EXT FAX FEM FLG FRM FRT GRP GSM GTC IDN IMO LBO LIA LIC LMS LST MAL Analyst Animal Bag Block Bank Box Brood Birth Cage Code Check Digit Comment Count Card Certificate City Description Delivery D N A Document Destination Date Death Email End Export Extension Fax Female Flag From First Group GSM Genetic Identification Import Lable Liabilities License Live Last Male Sanitrace EAI Manual Draft v 1 5 NBR NEW NRS NUR OCR OLD ORD ORI PCR PLT PNT POP PPT PUR QAL RCV RDC REF RLM RGS RQS RSK RSP SGP SMP SRC STA STB STR SUC TOT TPH TRS TWO UPD VAL VAT VGN VRS VRV VTY WGH YER Number New Nourish Nursing Occur Old Order Originator Producer Plate Print Population Passport Purchase Qualifications Receive Rendac Reference Realm Register Request Risk Responsible Subgroup Sample Search Status Stable Street Surface Total Telephone Transporter Two Update Value BTW TVA Vignette Version V R V Veterinary Weight Year EAIManual0071117 doc 16
54. Token N A ResultIndex 0 gt lt ProductionUnit gt lt FCLT_CDE gt BE 70057407 lt FCLT_CDE gt lt DTE_FRM gt 2006 12 01T00 003 oe DTE_FRM gt lt DTH_TO gt 2007 11 30T23 59359 lt DTH_TO gt lt Produection nit gt Product1onUiii Export Request Example 2 Retrieve all production unit details of a certain production unit in a certain facility over a certain period Includes all animals that were part of this Production Unit in any period overlapping with the specified period lt ProductionUnitExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt ProductionUnit gt lt FCLT_CDE gt BE 70057407 lt FCLT_CDE gt lt PRUN_REF_NBR gt 123456789 lt PRUN_REF_NBR gt DEE SE RM gt 2006 12000 00007 DTE FRM BE ING PO Fh WSO ES SHS DTH_TO gt lt Production nit gt RroductienUnieb lt potReguest Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 49 Example 3 Retrieve all production unit details of a certain production unit over a certain period Includes all animals that were part of this Production Unit in any period overlapping with the specified period As the production unit 1s part of a facility this 1s more or less equivalent too 2 ProductionUnitExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitExportRequestSchema User TESTXML Sec
55. _CNT gt GCSE DEP EO EE lt VRV_IDN_CRD_FLG gt false lt VRV_IDN_CRD_FLG gt SENSIT IE VI SNPTPSCDE DDBESZNPIPSODE LODE BEA EE lt Party gt eo ME TE EDE HE NE IE ODE lt CDE gt BE03313736 lt CDE gt Poe lt Facility gt lt NETPACDE SRC lt NETPZCDE lt CDE gt BE40141489 lt CDE gt lt SNUN_CDE gt BE40141489 0101 lt SNUN_CDE gt Pace lt Facility gt lt NFTP_CDE gt DST lt NFTP_CDE gt lt CDE gt BE03313736 lt CDE gt mc Animal lt REF_NBR gt DE 0580027802 3 lt REF_NBR gt lt PPT_VRS_NBR gt 3 lt PPT_VRS_NBR gt lt Animal gt lt MovementNotification gt lt MovementNotificationImport gt Arrival at Rendac Simple lt xml versier vd OU Movement NotificationImport xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 org 2001 XMLSchema User TESTXML xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema gt lt MovementNotification gt lt NOTP_CDE gt MMDPT lt NOTP_CDE gt lt OCR E 70 010 9 TE MER ANTP CDE BOV ANTP CDE lt ANSB CDE BOVS ANSB CDE lt ANDT CDE gt C36 lt ANDT_ CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt DEAD lt ANCO_CDE gt lt Facility gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Li ME TE DE DT NEFIE EDE lt CDE gt BE03313736 lt CDE gt lt Paciilaty gt lt Animal gt lt REF_NBR gt BE118892877 lt REF_NBR gt lt Animal gt lt
56. a Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 13 Interface IMMVN ImportMovementNotification Direction Import Purpose Submit a movement e g Mobile App Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacingS vcs SanitraceServices asmx o ImportMovementNotification Input Schema MovementNotificationlmport EFS MovementNotificationimport MovementNotificationImport PPPM MovementNotification MovementNotification User string dr SecurityToken string OnBehalfRole string OnBehalfEntity string v EMovementNotification MovementNotification m mm mm mm mm mm mm mm mm mm m E Ee Party NOKD_CDE string E E NPTP CDE string OCR DTE dateTime E CDE string RCV DTE dateTime REF NBR string DOC NBR string ANTP CDE string ANSB CDE string ANM CNT decimal EIS Facility ANCO_CDE string E NFTP_CDE string CRF_NBR string E CDE string LIC_PLT string d E FALO REF NBR string CTRY_CDE_FRM string f E SNUN_CDE string CTRY_CDE_TO string ADPR_CDE string VRV_IDN_CRD_FLG boolean CMN string Hi Animal Party Party E REF_NBR string Facility Facility E PPT_VRS_NBR int Animal Animal E SLG VGN NBR string ANDT_CDE string E PRUN_REF_NBR string Ka http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema XML Example s Departure of an animal from a FARM
57. a types string decimal decimal point datetime DateTime YY YY MM DDTHH MM SS FFF UCT Examples 2007 03 01 2007 03 01T 10 04 12 A Null date time can be represented as 0001 01 01T00 00 00 Best practices o Cardinality and structure complexity Oto limited rather than minimal and maximal 3 Minimal Depth and Redundancy Similar information requirements Similar field names o Import Interfaces Multiple input records possible Standardized interaction result o Export Interfaces Request Single Line Search Criteria gt but all criteria freely combinable Result list result o Standardized Header Info Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 11 All Headers e Username name of the user on whose behalf the import is made this user needs to have the adequate permissions as if he would register this action in the online e Security Token Reserved if a stricter security is necessary in case of XML abuse Extra Header Info Export Results e Return Code can be negative in case the search failed e g missing incorrect search criteria 0 means all OK A Return code 999 will mean that the result 1s truncated to the first 1000 results e Return Message specification why the search failed Extra Header Info Export Request Steering Parameter e Result Index ReservedPaging parameter in case of multiples of X000 of records 1 first X000 2 second X000 R
58. able and hence extensible An initial list of possible attribute codes is given in the table underneath Obviously depending on the context these attributes can trigger changes on animals sanitary units parties or facilities Some attributes reappear in multiple categories this has more to do with the display on the screens Currently a change notification should only update attributes in one category Cat Category Name Attribute Code Attribute Description ANMC Animal Characteristics HRTP CDE Hairtype Code ANRT_CDE Animal Race Type ANRC_CDE Animal Race GNDR_CDE Gender ANSB_CDE Animal Sub Type ANMB Animal Birth BTH_DTE Birth Date FCLT_CDE_BTH Code Facility of Birth CDE_MHR Code Mother CDE_MHR_GTC Code Genetic Mother ANID ANRT Animal Identification MACT CDE Mearkins Couiunry Code MRK NBR Marking Number MRK NB R VRS I MRK NBR VRS 2 ANLO CXNLE Animal Location FCLT_CDE Facility Code SNUN_CDE Sanitary Unit Code ANAT CXNCD Animal Attributes CDE_MHR Code Mother CDE_MHR_GTC Code Genetic Mother ANSB_CDE Animal Sub Type ANRT_CDE Animal Race Type Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 68 ANMN Animal Movements ADNA Animal DNA AVRV Animal VRV ADR Address Sanitrace EAI Manual Draft v 1 5 ANRC_CDE ASRV_CDE GNDR_CDE HRTP_CDE EXT_GRP_NBR EXT_SGP_NBR PRUN_REF_NBR IMO_DTE EPO_DTE FCLT_CDE_BTH FCLT_CDE_END ORI_NBR CRF NBR CTRY CDE IMO CTRY CDE EPO DNA ANA FLG DNA A
59. ace Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Table Of Contents Biere ene 2 Table OD e A EE RE EE EG Se De Ee ER DE iii 5 rte oi E RE AR ER OE RE N 7 AM and Web Servi es ER Ee Re Ee ee Se se ee Ee 7 EE 8 SUI RO NR RR RR RR AE EE LE IP 9 SCHEMA design CONV COUOINS lilla 11 Scherna De miniserie 13 Codines Schema S Overview ee eege 14 Main EDO y EE 15 EE 15 Codines Schema S Contents ed BE ee ee Re GE ari 18 Interface EIERE 28 Intertace EXAIN ExPOnAn D EE 28 Interface EXAMN ExportAnimalMovementNotificationOverview 30 Interface EXANO ExportAnimalOverview ss 32 Interface EXCNO ExportChangeNotificationOverview ee ee ee ee ee ee 35 Interface EXFAO ExportPacilityOVetrvie Wes dees es SS Ge ee Ee die 37 Interface EXMNO ExportMovementNotificationOverview ss 39 Interface EXMVN ExportMovementNotification n 4 Intertace EXPAO ExportPartyOVerVie Wa choice iero 43 Interface EXLPO ExportLiablePartyOverview ss 45 Interface EXPUO ExportProductionUnitOverview i 47 http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitOverviewE MORSE MCN Lie 48 Intertace EXPU ExportProductronU Bib s oou ee aa 49 Intertace EX SU EXpottSanttary UTI o2 EG a nd eO NP end be aedes 51 Interface EXSUO ExportSanitaryUnitOverview ss 53 Interface EXSLO ExportSlaughteringOverview esee 5
60. angeNotification ChangeNotification E REF MER string A User SEH E E ANTP CDE string 1 A SecurityToken string E ZIP string 1 A Resultindex int E NORS CDE string E PATY CDE string E FCLT CDE string E SNUN CDE string E ANML CDE string E ATRB CDE string E DTE FRM dateTime E DTE TO dateTime http Sanitrace EAI SanitraceRepository SanitraceServices ChangeNotificationOverviewExportRequestSchema XML Example s Example EXCNO 1 Retrieve all changes on animals bovines on a certain day ChangeNotificationOverviewExportRequest User TESTXML SecurityToken N A ResultIndex 0 xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ChangeNotificationOverviewExportRequestSchema gt lt ChangeNotification gt lt NOTP_CDE gt CHANM lt NOTP_CDE gt lt DTE_FRM gt 2008 09 25T00 OOO lt 7 PIE RIE DEE IE OO OD MS 59 lt DTE_TO gt lt ChangeNotification gt lt ChangeNotificationOverviewExportRequest gt Example EXCNO 2 Retrieve all changes on sheep facilities over a certain month lt ChangeNotificationOverviewExportRequest User TESTXML SecurityToken N A ResultIndex 0 xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ChangeNotificationOverviewExportRequestSchema gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 35 Output Schema ChangeNotificationOverviewExport ia ChangeNotification ChangeNotification E ChangeNotification ChangeNotification A User A SecurityToken
61. areservices ExportAnim IEEE lEequest A nimal 0 A NTP CDE c BOU lRequest Animal 0 CDE MES SSEr nimalExport lResult lFroxy Export inimall l1Reguest Web Service Proxy Net calls As such you actually get long names in your code which can be a bit confusing However as you get the method name structure name structure table insight it is rather straightforward again Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 97 Channels 2 to 4 The examples given in this document actually where slightly altered for better readability i e the xmins directive should be without spaces linebreaks The XML as such should look like EXPA 2 Retrieve all Slaughterhouses correct XML lt xml version 0 cencodamge uino lt PartyOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportRegu ssi o cere User TESTXML SecurityToken N A ResultIndex 0 gt coevi lt PATP_CDE gt SLGHS lt PATP_CDE gt Date The zip file underneath contains some example XML files these can be used by all subsequent scenario s as these work with pure XML files rather than Web Services Obviously the XML s are formed according to the schema s defined above TODO as soon as the code operational add a zip file of the above XML examples but with actual examples Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 98
62. ationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalMovementNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt Movement gt lt DTE_FRM gt 2007 11 10T00 00 00 lt DTE_FRM gt lt DTE_TO gt 2097 11 15T23 59 59 lt DTE_TO gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt PATY CDE TRS gt BE123456789 lt PATY CDE TRS gt lt Movement gt lt AnimalMovementNotificationOverviewExportRequest gt Output Schema AnimalMovementNotificationOverviewExport This schema is slightly more general than strictly necessary In fact a distinction could have been made between individual animals and herds If called for herd animals these fields remain empty CS ovement Movement E NOTF ID long E NOTP CDE string E NOKD_CDE string E NOST_CDE string E OCR_DTE dateTime E REF_NBR string E ANTP_CDE string E ANSB_CDE string E ANCO_CDE string inimalMovementNotificationOverviewExport KAnimalMovementNotificationOverviewExport aed ue E Movement Movement E LIC PLT string n EE ke string E ZIP string a See L string E PATY_CDE_TRS string Arre i E FCLT_CDE SRG string E FCLT_CDE_DST string E SNUN_CDE string E ANML_REF_NBR string E ANML_EXT_REF_NBR string E BTH_DTE dateTime E HRTP_CDE string E GNDR_CDE string E ANRC_CDE string E ANRT_CDE string E CDE_MHR string Sanitrace EAI Manual Draft v 1 5 EE ME DEN http Sanitrace EAI Sanit
63. cation Contact the general helpdesk for a user id If you re a system integrator ask a Logon ID in the QAS environment and have it configured for one of the slaughterhouses you work for Please inform the slaughterhouse about this 15 Q Can I put everything in uppercase A No you cannot XML is case sensitive so your structure tag names e g for SanitaryUnit need to be exactly lt SanitaryUnit gt and not lt Sanitaryunit gt lt sanitaryunit gt or lt SANITARYUNIT gt The same applies to a namespace definition like xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOvervie wExportRequestSchema 16 Q My test XML gives an error and I copied it from your example A for readability we sometimes entered extra spaces is the XML especially in the namespace definition copying the example blindly will not work E g the example shows xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverview ExportRequestSchema But it actually is one string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PartyOverviewExportRequestSchema 17 Q My XML still gives an error A As long as you get Error in XML your XML is not formatted correctly reasons can include e Incorrectly closed tags e Special characters like in strings e Non date representations 9 au Most of the time the parser also gives a location e g line 12 char 44 go to the corresponding line column and check th
64. e error It should be close in the neighbourhood there 18 Q How can I specify an empty tag A We support the standard W3C empty tags techniques For strings this includes Animal No tag lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SNUN_CDE gt BE10014385 0101 lt SNUN_CDE gt lt Animal gt lt Animal gt Closed tag lt FCLT_CDE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SNUN_CDE gt BE10014385 0101 lt SNUN_CDE gt lt Animal gt lt Animal gt Open Close tag lt FCLT_CDE gt lt FCLT_CDE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt gt STRINGS ONLY lt SNUN_CDE gt BE10014385 0101 lt SNUN_CDE gt lt Animal gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 109 For datetimes this includes Animal No tag lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SNUN_CDE gt BE10014385 0101 lt SNUN_CDE gt lt Animal gt Animal Null values lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SNUN_CDE gt BE10014385 0101 lt SNUN_CDE gt lt UPD_DTE_FRM gt 0001 01 01T00 00 00 lt UPD_DTE_FRM gt lt UPD_DTE_TO gt 0001 01 01T00 00 00 lt UPD_DTE_TO gt lt Animal gt lt AnimalOverviewExportRequest gt For other XML types there is only the No Tag option 19 Q How can I see the field lengths A Technically speaking field length specifications are not standard part of XML There have been proposed some standards but the general conclusion of any such debate is always that XML should not be specifying lengths
65. e old numbering system has numbers like BE 123456 so only containing 6 numeric positions instead of the 8 numbers currently used Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc DK327 701486 BE101 3701 0101 DK329962453 BE101 3 01 0101 LU724645 BE30041613 0101 LUS23435 BE30041613 0101 BE9018347 HE10111021 0101 BEA5173747 BE10111021 0101 BEA5187298 BE10111021 0101 BENO0042909 BE10111021 0101 IEBMORO019W BE30041613 0101 IECFCHOOOAX BE30041613 0101 IEDCMVOO2O0K BE30041613 0101 IEFFZPOO43K BE30041613 0101 5K90266814 BE30041613 0101 5K03232165 BE30041613 0101 So as output we return the animal numbers in the most informative way So INCLUDING information about country and check digit and all separated by a blank CDE LT 03119426 CDE BES 65794680 Companies not interested in the check digit can ignore the spaces For input we allow the formats with spaces without spaces and for bovines from the BENELUX we even accept them without checkdigit 21 Q Are we forced to use Security Tokens A So far we only implemented base level security in order not to make it too complex for the user community This is possible because the external risk that the information is hacked abused for malafide manipulation or financial gain is rather limited The Internal risk is low too as this is a trusted community rather than an end user community Although we do have quite some loggings to assure the risk stays low Finally a lot of the impor
66. eNotificationImport gt XML Example 2 cancelling a treatment via notification reference number lt xml version 1 0 encoding utf 8 gt lt StatusUpdateNotificationImport User string SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices StatusUpdateNotificationImportSchema gt lt StatusUpdateNotification gt lt NOTP_CDE gt TMT lt NOTP_CDE gt lt REF_NBR gt 5006782 lt REF_NBR gt lt WF_ACT gt CAN lt WF_ACT gt lt StatusUpdateNotification gt lt StatusUpdateNotificationImport gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 88 Output Schema Interaction Result See definition Interaction Result Schema Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 89 InteractionResult Purpose Schema to give feedback regarding an import of information Schema 9 E datz frravOfMessag MA essagetntry MessageEntry E StatusCode Status E MessageEntry MessageEntry E Code int E Summary string E Description string E Reference string E Pattern string E Details Array OfMessa E Argumentscs string E Reference string zm F enumeration Success F enumeration Error F enumeration Warning http Sanitrace EAI SanitraceRepository InteractionResult On success you receive an interaction result like shown underneath Important is the StatusCode Success and the Reference 868
67. eServices Sanitary UnitOverviewExportRequestSchema XML Example s Example EXSU 1 Retrieve all sanitary units of a certain facility SanitaryUnitOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices SanitaryUnitOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt Sanitary niLt gt lt FCLT_CDE gt BE70057407 lt FCLT_CDE gt EE SanitaryUnitOverviewExportRequest Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 53 Output Schema SanitaryUnitOverviewExport E SanitaryUni SanitaryUn A User string d A SecurityTo string p A ReturnCod string E A RetumMes string m m m Mm Mm mm mm mm mm mm mmm m m m m m m m m m m m m m m m m m m m m m m m m m m m momo m m mo m m m m m m m m m m M anitaryUnit SUTP CDE CDE NAM REF NBR EXT REF NER ANTP CDE ANSB CDE BAG PBST CDE PBRS CDE SUKD CDE PRQU CDE BAG PRWA CDE BAG SUHS CDE BAG POP CNT UPD DTE FCLT CDE FCLT NAM FCLT REF NBR FCLT EXT REF NBR FLTP CDE FALO REF NBR ALI AL2 STR NBR BOX ZIP CTY MCP CTRY CDE TPH RSP CDE RSP NAM RSP REF MBR RSP EXT REF NBR RGD ALT RGD AL2 RSP STR RSP NBR RSP BOX RSP ZIP RSP_CTY RSP_MCP RSP_CTRY_CDE RSP_TPH TUST_CDE GEO LAT GEO LON GEO X GEO Y GXYS CDE GEO STR LTH GEO PLG DEF GIS REF dateTime string string string string string string string string string string string string string string strin
68. ee definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 78 Interface IMPPN ImportPopulationNotification Direction Import Purpose Submit population inventory results Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ImportPopulationNotificatio Input Schema PopulationNotificationimport E cpulstionnotification PopulationNotification E aty CDE ca E NOTP CDE string E CDE 7 can E NOKD_CDE string sering E OCR_DTE dateTime E RCV DTE dateTi CFosonotiicationmpot PopulationNotificationImport E REF NER z de E PopulationNotification PopulationNotification E DO C NBR Sie AU tri r E ANTP_CDE_ALT string UE LGercomt Populationcount E FCLT_CDE string E ANSB CDE string E SNUN CDE string E PRWA CDE string E f a E M SH E SUHS_CDE string arty Party E PRQU CDE string E PopulationCount PopulationCount E POP CNT decimal http Sanitrace EAI SanitraceRepository SanitraceServices PopulationNotificationImportSchema XML Example s lt PopulationNotificationImport User string SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices PopulationNotifticationIimoort gt lt PopulationNotification gt lt NOTP_CDE gt string lt NOTP_CDE gt lt NOKD_CDE gt string lt NOKD_CDE gt lt OCR_DTE gt dateTime lt OCR_DTE gt lt REF_NBR gt string lt REF_N
69. emark that we use the Header of the MessageType for storing these special information elements This is a preferred practice over e g the use of a special context element for the following reasons Security and routing can be done on just the information in the header of the message without the need to parse the full message structure The header info can be extended e g with message version information again accessible without the need to parse the full message structure Conceptually the header info is NOT part of the message so it should not be part of a special context element Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 12 Schema Definitions The attached zip file contains a collection of all schema s Schemas zip XSD Schema s When discussing channel 1 we also explain how one can retrieve the XSD Schema s online Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Coding Schema s Overview The following coding schema s have been used in the XML definition CleaningFacility Type Country FacilityLocation Type NotificationStatus Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc RIQR RiskQualificationReason Type of treatment item e g 1 27 Main Entity Overview The following 4 letter codes refer to a main entity You have to know their key before you can access them Order Items e g Retagging Earmarks Abbreviations
70. equestSchema XML Example s Example EXSU 1 Retrieve detailed information of a sanitary unit SanitaryUnitExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices SanitaryUnitExportRequestSchema User TESTXML SecurityToken N A gt lt SanitaryUnit gt lt CDE gt BE12345678 0101 lt CDE gt lt SanitaryUnit gt lt SanitaryUnitExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc SI Output Schema SanitaryUnitExport E anitaryUnitExport SanitaryUnitExport E SanitaryUnit SanitaryUnit A User string A SecurityToken i A ReturnCode A ReturnMessage di siSanitaryUnit m E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E E SUTP CDE NAM REF NBR EXT REF NBR ANTP CDE ANSB CDE BAG PBST CDE PBRS CDE SUKD CDE PRQU CDE BAG PRWA CDE BAG SUHS CDE BAG POP CNT UPD DTE FRM UPD DTE TO FCLT CDE FCLT NAM FCLT REF NBR FLTP CDE FALO REF NBR AL1 AL2 STR BOX ZIP CTY MCP CTRY CDE TPH Party ProductionUnit Marking Capacity History PopulationCount Risk decimal dateTime string Party ProductionUnit Marking Capacity History PopulationCount Risk LL LL LL LL LL LR LL LR LL LR LL EE RL LR RL LR LR RL RL LR RL LR RL LR RL LR RL LR RL LL RL LL LA E E E E E E E KAAR SS arty Party SPTP_CDE string i CDE string NAM string d REF
71. er That s where the security token comes into play In practice you still can leave the security token blank as this is a trusted user community In addition you need to know the other user name and last but not least we do quiet some tracing on IP address level to detect abuse or to do some analysis in case abuse 1s detected This XML tracking also includes the content of the XML request so we actually can verify if XML users do not abuse there XML capabilities by querying information they should not access So no additional Web Service Security 1s for the time being still an option Nevertheless we do invite you to implement one of the method security elements discussed underneath And as soon as you are on level 3 or 4 you also make the life of the hacker a lot more difficult We now discuss how in the online application the XML security can be configured This is done in tab 6 in the user profile In this tab we manage some advanced security settings managing connectivity with the application both in the online as well as for the XML The settings defined in this tab will define how you need to send your XML messages Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 103 waa Pf o2 H oa pa H ps U ps 324 Update Profile Must Use SSL Logon Checkbox This flag indicates whether this User should logon via the Secure Server If the user logs on via the normal login he is blocked for 2 minutes We deliberately d
72. er you can search on this 9 digit zero prefixed number too for finding the party and in case it is not there you can fetch its BOOD KBO information when creating the party 1 e create simple party maintenance tab to field external reference number gt enter the 9 digit zero prefixed FAVV BOOD KBO number gt Hit the check button gt Name address info 1s fetched 4 Q And foreign cattle farms should we create those too as temporary parties A No in the XML structure there is the document tag where you can specify the certificates of these foreign cattle farms Both local or international TRASYS certificates can be used 5 Q What 1s the difference between a Party and a Facility A The Party is the Juridical entity and is in the process of being rationalized and aligned with the Central KBO registration the Facility is the more down to earth number of a certain facility on a certain location One party can be responsible for multiple facilities but a facility only has one liable party 6 Q Can we register now multiple transporters via the XML A Yes you can just an extra Party Tage with SLPT_CDE code TRS 7 Q Can we now register dead animals via the XML A Yes you can See example 2 Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 107 8 Q Can we put local animals and foreign animals in one SlaughterFile A No you can not The origin code ORIG_CDE has to be filled in on Slaught
73. erFile level and indicates 1f the animals come from abroad or local So you need to split the declaration 9 Q I get PATY_CDE mandatory FCLT_CDE mandatory messages What do they mean A I agree the error messages are not always optimal but it typically refers to not specified or incorrectly specified parties Submittor Owner Transporter or facilities Please check whether your specified codes are filled in and are in the correct format BE12345678 10 Q What s the difference between SAV Saving and SUBM Submitting a declaration A As soon as you SUBMit a declaration it is the signal that the inspections can take place and it cannot be altered anymore When SA Ving a declaration you can do an update later e g if you want to change weight categories or so However a manual or XML SUBM it is needed to progress the workflow 11 Q I just use trial and error and sometimes the messages are somewhat hard to understand Is there a possible overview of all that can go wrong What other messages are there A I agree the error messages are not always optimal and unfortunately I do not have an exhaustive list of all possible errors you can make when doing trial and error XML filling but it is a point where we try to improve continuously The most visible error checking is on the possible code value schema s and mandatory fields but excessive field lengths or duplicate keys can result in less user friendly messages On the o
74. ere ibus ey lt FacilityOverviewExportRequest gt Example EXANO 2 Retrieve all facilities that were updated this month FacilityOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices FacilityOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt Facility gt lt UPD_DTE_FRM gt 2007 11 15T00 00 00 lt UPD_DTE_FRM gt lt UPD_DTE_TO gt 2007 11 15T23 59 59 lt UPD_DTE_TO gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 37 AR lt FacilityOverviewExportRequest gt Output Schema FacilityOverviewExport NE E FATP CDE stri CDE NAM REF NBR EXT REF NBR 4522252525258 25 disi FacilityOverviewExport Facility OverviewExport E Facility Facility A User string A SecurityToken ring CTRY CDE ri TPH LIA_CDE LIA NAM LIA REF NBR LIA EXT REF NBR LIA ALI LIA AL2 LIA STR LIA NEK ring UPD DTE dateTime GEO LAT decimal GEO LOM decimal GEO X decimal GEO Y decimal GXYS CDE string GEO STR LTH decimal GEO PLG DEF string GIS REF string ring ring ring ring ri ri A ReturnCode ring ri A ReturnMessage ng ring ring ring ring ad AA AAR AA http Sanitrace EAT SanitraceRepository SanitraceServices Facility OverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXMNO ExportMovementNotificationOverview Direction Export Purpose Retrieve an overview of m
75. erman MSAL Marking Series Allocation Allocation manually Recuperation for stock ALROR ORGRA Manual allocation from Origin Register NFTP NotificationFacilityType Source Destination Participating NOKD NotificationKind ARV DPR Departure MMT R6 Los LN Not commercialised Bovine PRNT Change Exploitation PRNT ar ik lpr H49 unit PRNT met Gage e e oar o R51 Change PRNT Change Address Main Location IBR IBR TMT BOVE TMT BOV TMT PLTRY BIRD TMT PLTRY BIRD Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 20 IM injection IN injection F ORALE Oral use feed TMT BOV SHP GOAT DEER PLTRY BIRD PIG POUR Pour on methode TMT BOV SHP GOAT DEER PLTRY BIRD PIG V injection TMT BOV SHP GOAT DEER PLTRY BIRD PIG IMMIJ IMM injection TMT BOV SHP GOAT DEER PLTRY BIRD PIG IPINJ IP injection TMT BOV SHP GOAT DEER PLTRY BIRD PIG ORALW TMT BOV SHP GOAT DEER PLTRY BIRD PIG Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 21 NOST NotificationStatus Draft Cancelled ENT HEJ Hejected Invalid New Submitted Accepted Federation Rejected Federation Split Submitted Fed NOTP NotificationType Birth Import MMARV MovementArrival MovementUnload MMIMO Movementlmport MMDPS MovementDepartureSlaughterhouse MMDPD MovementDepartureDisposal MMTRS MovementTransportation ChangeParty RISK Risk ParentMovement M
76. g string string string string string string string string string string string string string string string string decimal decimal decimal decimal string decimal string string http Sanitrace EAI SanitraceRepository SanitraceServices Sanitary UnitOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 54 Interface EXSLO ExportSlaughteringOverview Direction Export Purpose Retrieve summary statistics of slaughtered animals In process Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportSlaughterineOvervie Input Schema SlaughteringOverviewExportRequest http Sanitrace EAI SanitraceRepository SanitraceServices SlaughteringOverviewExportRequestSchema XML Example s Output Schema SlaughteringOverviewExport http Sanitrace EAI SanitraceRepository SanitraceServices SlaughteringOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 55 Interface EXAGR ExportAgreementOverview Direction Export Purpose Export Agreement Information Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ExportA ereementOverview Input Schema ExportAgreementOverviewExportRequest greement Agreement E AGRE ID long E AGRE CDE string E REF NBR string E EXT REF NBR string greementOverviewExportR AgreementOverviewExporth E AG
77. g 2001 XMLSchema instance xmlns xsd http www w3 org 2001 XMLSchema User TESTXML SecurityToken N A OnBehalfRole 0 OnBehalfEntity 0 xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema gt lt MovementNotification gt lt NOTP_CDE gt MMARV lt NOTP_CDE gt lt OCR DTE gt 2008 11 04T16512 24 lt 0CR_DTE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANM_CNT gt 1 lt ANM_CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt meom DR AS nae EE EE lt NPTP_CDE gt TRA lt NPTP_CDE gt lt CDE gt BE12002473 lt CDE gt SR EE lt NPTP_CDE gt DLR lt NPTP_CDE gt lt CDE gt BE12500104 lt CDE gt lt Party gt lt Facility gt lt NFTP_CDE gt DST lt NFTP_CDE gt lt CDE gt BE12500104 lt CDE gt lt SNUN_CDE gt s Paci ges Animal REF NBR 2BEIIS273633 REF NBR gt PPT VRS NBR 2 PPT VRS NBR Animal MovementNotification lt MovementNotificationImport gt Arrival multiple animals on a Market lt MovementNotificationImport User UDLR SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema gt lt MovementNotification gt lt NOTP_CDE gt MMARV lt NOTP_CDE gt OCRED RE 2003 MO dee AA OER IE HE REF NBR 212345678 REF NBR DOC NBR DOC NBR lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 75 lt
78. gt ANIMAL Country MarkingNumber BE 00004461 ArgumentsCSV lt Reference gt lt MessageEntry gt lt Details gt lt InteractionResult gt Or when requested with user language NL ali esilio n RO lt InteractionResult xmlns xsi http www w3 0rg 2001 XMLSchema instance xmlns xsd http www w3 0rg 2001 XMLSchema gt lt StatusCode gt Error lt StatusCode gt lt Summary gt Import ImportChangeNotificationUseCase erroneous Change Notification Importing 2322 343453 ChangeNotification information is not imported See logs for more information lt Summary gt lt Reference gt lt Details gt lt MessageEntry gt lt Code gt 266 lt Code gt lt Description gt Record niet gevonden in tabel Dier voor opzoekcriterium Land Werknummer met waarde BE 00004461 lt Description gt lt Pattern gt Record not found in table 0 for search criterium i with value 12 lt Pattern gt lt ArgumentsCSV gt ANIMAL Country MarkingNumber BE 00004461 lt ArgumentsCSV gt lt Reference lt MessageEntry gt lt Details gt lt InteractionResult gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 9 Working On Behalf Of To support 3 party services we added work on behalf of functionality The principle is quite simple Besides passing user security token you know pass two additional information elements OnBehalfRole The application role of the entity you are working on behalf of e g FARM
79. her your xml is correctly filled in In case your streaming does not work or give satisfactory results please test it first using the manual scenario Be sure you get on this page and NOT on the XML upload page for the slaughter module Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 100 Next Steps Focus now will be on three domains 1 Tuning the web services 2 Finalizing the remaining interfaces or reports a Water Manure b Slaughtering statistics c Bovine population statistics 3 Moving to production URL Summary For testing in the ongoing development environment e http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs GenericX ML Handler ashx e http gas sanitrace be int QAS_Sanitrace ExtInterfacingSvcs SanitraceServices asmx e http qas sanitrace be web QAS Sanitrace Web Pages Common Upload XMLPage aspx The Luxembourg URLs All URLs specified contain the word QAS at least once in the URL For Luxembourg production all of the above will remain the same except that the characters qas or QAS need to be replaced by prd or PRD In addition all interface URLs and definitions will be standardized on the Sanilux naming and the be suffix needs to be changed to lu Le http gas sanitrace be int QAS_Sanitrace ExtInterfacingSvcs GenericXMLHandler ashx will become http gas sanitrace lu int QAS_Sanilux_ExtInterfacingSvcs GenericXML Handler ashx http gas sanitrace lu int QAS_ Sanilux ExtInte
80. ices AnimalOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt Animal lt ANTP_CDE gt BOV lt ANTP_CDE gt lt UPD_DTE_FRM gt 2007 11 15T00 00 00 lt UPD_DTE_FRM gt lt UPD_DTE_TO gt 2007 11 15T23 59 59 lt UPD_DTE_TO gt lt Animal gt lt AnimalOverviewExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 32 A query like this one can take some time as we have choosen for now not to put an index on it yet in addition because of the migration all animals last update date will be the day of the migration If this query is to be used structurally and regularly let us know Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 33 Output Schema AnimalOverviewExport E AnimalCverviewExpartf amp nimalCrerviewExpor E Animal A User A SecurityToken A ReturnCode A ReturnMessage Animal string string string string E E ANTP CDE string E CDE string E MACT CDE string E MRE_CDG string E MRK HEF string E FCLT CDE string E SHUM_CDE string E CDE MHR string E CDE MHR GTC string E BLST CODE string E TUBR CDE string E ANSE CDE string E AMRC CDE string E AMRT CDE string E ASRV CDE string E GNDR_CDE string E HRTP_CDE string E BETH DTE dateTime E DTH_DTE dateTime E PRUN_REF_NBR string E EXT GRP MBR string E EXT SGP HER string E FCLT CDE ETH string E FCLT CDE EMD string E CTRY CDE IMO string E CTRY CDE EPO string E DINA AMA FLG boolean
81. irection it s short description it s input and output schemas etc Interface EXAN ExportAnimal Direction Export Purpose Retrieve a detailed insight of an animal All characteristics risk status history Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op zExportAnimal Input Schema AnimalExportReq nimalExportRequest AnimalExportRequest Animal nimal E Ani Animi SE e E ANTP CDE string A User string A E CDE m SecurityToken string http Sanitrace EAT SanitraceRepository SanitraceServices AnimalExportRequestSchema XML Example s Example EXAN 1 Retrieve detailed animal information for two bovines a local one and an imported one AnimalExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalExportRequestSchema User TESTXML SecurityToken N A gt lt Animal gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt CDE gt BE12345678 lt CDE gt lt Animal gt lt Animal gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt CDE gt NL456453543 lt CDE gt lt Anime ll lt AnimalExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Output Schema AnimalExport bania Animal E ANTP CDE string E CDE string E MACT_CDE string E MRK CDG string E MRK NER string E FCLT CDE string E SNUN_CDE string E CDE MHR string E CDE MHR GTC string E BLST CDE string E TUB
82. itrace EAI SanitraceRepository SanitraceServices MovementNotificationExportRequestSchema XML Example s Example EXFAO 1 Retrieve the full detail for movements 300034 and 300035 lt MovementNotificationExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationExportRequestSchema User TESTXML SecurityToken N A gt lt Movement gt lt ID gt 300034 lt ID gt lt Movement gt lt Movement gt lt ID gt 300035 lt ID gt lt Movement gt lt MovementNotificationExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 4 Output Schema MovementNotificationExport Movement Movement ID long NOTP CDE string NOKD CDE string NOST CDE string RCV DTE dateTime OCR DTE dateTime REF NBR string EXT REF NBR string ANTP CDE string MovementNotificationExport MovementNotificationExport E Movement Movement ANSB_CDE string A User string ANM_CNT long A SecurityToken string ANCO_CDE string DOC_NBR string EPO_CRF_NBR string CTRY CDE EPO string IMO_CRF_NBR string CTRY CDE IMO string mmm mm MM MM MM MM MM MM MM MM LIC PLT string Party Party Facility Facility Animal Animal http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationExportSchema Sanitrace EAI Manual Draft v 1 5 Party Party E NPTP_CDE string ES E CDE string E NAM string E REF NBR string E EXT REF NBR
83. its Output Schema ExportAgreementOverview AGRE ID long AGRE CDE 1 AGTP CDE AGSA CDE string BEG DTE dateTime END DTE dateTime REF NBR BEG string REF NBR END string EXT REF NBR BEG 1 EXT REF NBR END APTP CDE1 PATY CDE1 PATY_NAMI1 APTP CDE2 PATY CDE2 PATY NAM2 string UPD DTE dateTime E Agreement A User A SecurityToken A ReturnCode A ReturnMessage http Sanitrace EAI SanitraceReposito SanitraceServices Ex ortAereementOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 57 Interface EXMS ExportMarkingSeriesOverview Direction Export Purpose Export Marking Series Overview Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ExportMarkingSeriesOverview Input Schema MarkingSeriesOverviewExportRequest MarkingSeriesOverviewExportRequest MarkingSeriesOverviewExportRequest E a a 3 E PATY_CDE SUP sig A SecurityToken string E OISN CDE string A ResultIndex int e E ALC_DTE_FRM dateTime A OnBehalfRole string E ALC DTE TO talc Tene A OnBehalfEntity string E UPD DTE FRM dateTime E UPD DTE TO dateTime A UserLanguage string http Sanitrace EAI SanitraceRepository SanitraceServices ExportMarkingSeriesOverviewExportRequestSchema XML Example s Example EXMS 1 Retrieve all marking series of allocated over a certain period lt MarkingSeriesOverviewExportRequest xmlns h
84. malImport and MovementNotificationImport Update Date Search on export movement animal movement VRV fields in import animal Extra animal fields in notification overview export MarkingSeriesImport added Working On Behalf Of functionality Oct 22 2008 e Added the slaughter vignet number Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc SLG VGN NBR in the Animal Tag of the MovementNotificationImport XML Completed ANCO codes in the documentation a rule has been added that in AnimalBirth registrations the SlaughteringCode DEAD cannot be used anymore Added SNUN CDE as search criteria for AnimalMovementNotificationOverview Added 2 Technical fields in interaction result defining the raw pattern string of the exceptions and the individual arguments Technical application integration can than check on the pattern string and retrieve certain parameters directly 1 19 Nov 5 2008 New Interface ExportMarkingSeries New Interface ExportRetaggingNotification Export AnimalOverview API Break Removal of the incorrect field VRV IND CRD FLG The correct field VRV IDN CRD FLG remains Work On Behalf Of Functionality added Nov 25 2008 Security Documentation added UserLanguage documentation added Dec 15 2008 Birth Import Examples Refreshed incomplete drawings Update FAQ Animal number formats Security Token Jan 7 2009 e ExportProductionUnit Interface Feb 15 2009 e ExportWaterManureAllocation Interf
85. mport interfaces always return an interaction result as result All document types are described in the interface description Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 10 Schema design conventions As there 1s no Industry XML standard for this type of information we have defined a number of dedicated schema s We tried to make this structure as consistent as possible and have made the following conventions The following interface design conventions were followed Full Schema definition in English Schema names Structure names Steering Attributes Camel Case No abbreviations Field Names o Abbreviation Based o Upper Case o 4 character abbreviations refer to a Coding Schema s or to a main Entity E g ANTP CDE denotes a code from the coding schema ANTP Animal Type E g FCLT CDE refers to the code id main reference number of a Facility o Rest3 2 character abbreviations o No indication of the type string number except for dates DTE or Booleans FLG o Fields as short as possible without jeopardizing readability Coding Schema s optimized for maximal stability o Coding schema s are NOT included in the schema new codes could be added without change in the interface o Minimal validation rules in the schema no input length definitions no mandatory fields gt All business logic on the Server o Only standard dat
86. n TreatmentNotification EE Facility E NFTP_CDE string E NOTP_CDE string E CDE E NOKD_CDE strin EXT reatmentNotificationimj TreatmentNotificationlm E OCR DTE cara E FALO_REF_NBR string E TreatmentNotification TreatmentNotification E OCR DTE END daieTime E SNUN CDE string A User string E RCV DTE dateTime A SecurityToken string B E REF NBR string d E DOC NBR Ge EA estmenerai KT reatmentDetail E ANTP CDE string E ANSB CDE mm E E L dis E TMLV_CDE string cd E MEDC_CDE string acility Facility E IDN lt trin E TreatmentDetail TreatmentDetail v E ANM CNT int 9 E QTY decimal E UNIT CDE QTY string E TITP CDE string E TMTP CDE string http Sanitrace EAI SanitraceRepository SanitraceServices TreatmentNotificationImportSchema XML Example s SE version 0 eneoding Vele lt TreatmentNotificationImport User string SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices TreatmentNotification Import gt lt TreatmentNotification gt lt NOTP_CDE gt TMT lt NOTP_CDE gt lt OCR_DTE gt 2008 04 11T11 30 00 lt OCR_DTE gt lt OCR_DTE_END gt 2008 04 11T12 30 00 lt OCR_DTE_END gt lt REF_NBR gt XXXX lt REF_NBR gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt CMN gt lt CMN gt lt Pabey lt NPTP_CDE gt HND lt NPTP_CDE gt lt CDE gt BE12345678 lt CDE gt lt Party gt SIAE lt NPTP_CDE gt RSP lt NPTP_CDE gt lt CDE gt BE87654321 lt CDE gt lt Party gt
87. nymousType true The effect 1s the following stub generation strategy WSDL SOAP Envelope zfxml wersion 1 0 amp encodinge ur 8 7 lt soap Envelope xmlins xsis http uwwu wi org zD001 XHLSchema instance xmlins xsde hrttp www wi org z001 XHLSc zmoap Body i nses hrrp Sanirrace EAI SanitraceReposirory SanirtraceServices ExportAnimal Request tRequest Users string SecurityTokens string Animals V CANTE CDE stringc ANTP CDE lt CDE gt string lt CDE gt mlns http Sanitrace EA I Sanitrace zAA nimal Bepnonzitory SanitraceSerwices lt Anima 1 gt Animale xport Request Schema lt ANTP_CDE gt string lt ANTP_CDE gt User we xSpx zCME stringz cCDE SecuritTokEken M A Anita l gt shnimal gt lt Animal amp xportRequest gt ANTP CDE BOV ANTP CDE lt Export Amingal gt CD E E R60 600 246 CDE gt lt soap Body gt z inimal lt soap Envelope gt Web Service WSDL Definition ANTP CDE gt BOV lt ANTP CDE ChE BE 606 O02 47s CD E gt Animal ras LEx port Be que st AML Structure sanitrace sanitracesergices lPxoxy new SanitraceService nr anitrace SanitraceServices Export nimal inimalExpor Begqguest lRequest new Sanitrace2ervices Export inimallinimalExportRBRedguesti lRequest User vzx5px lRequest 4Animal new Santtraceseryvices JExport4nimalfnimalExportReques din ima ije lRequest lnimal 0 new Sa itr
88. o NOT lock the user out because The password has been sent clear text over the line so the harm has been done anyway the https channel might be cloased down as protection against from a standard https virus attack Uses XML Checkbox The Uses XML checkbox is a flag that indicates that a certain LOGIN account can also use XML to load export information Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc XML Security Token Type This setting defines which Security strategy 1s followed in the XML messages 1 e it defines what is being passed in the security token The options are Security Token Hashed Security Token Date based Security Token Hashed Date based Security Token Key based Security Token Hashed Key based Security Token AES Encrypted Date Time Value Eom P coe The table underneath gives an overview of what the XML Security Token Settings are and additionally demonstrate how the security token can be filled in Finally column 5 gives an example iof the real security token as filled in in the XML example Security Token The security token SomeSecret SomeSecret plays the role of a kind of password 4 Hashed Date The security token is Some 0 Secret hNvdH haYJ4WAdMY Jx9vF ewpaQ Token key SomeSecret 5 Key based The security token is ome 0 Secret Some210Secret ma eee FEE key SomeSecret SomeSecret210 6 Hashed Key based The combined key Some 0 Secret bvVn9ub3ljlyOKKedP21024ftc Securi
89. oitation units are used at which facilities sanitary units Layout Documentation http qas sanitrace be int OAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportProductionUnitOverv iew Input Schema ProductionUnitOverviewExportRequest Productionlinit ProductionUnit E REF MBR string E PCR REF MBR string ProductionUnitOverviewExportRequest ProductionUnitOverviewExportRequest n E FCLT NAM string A Security Token string a SILE d A Resultindex i E FCLT_EXT_REF_NBR string E FCLT_ZIP string E ANTP_CDE string E UPD DTE FRM dateTime E UPD DTE TO dateTime E PATY CDE RSP string http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitOverviewExportRequestSchema XML Example s Example 1 Retrieve all production units of a certain facility lt ProductionUnitOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitOverviewExportReguest Schema User TESTXML SecurityToken N A ResultIndex 0 gt Produce mm gt lt FCLT_CDE gt BE 70057407 lt FCLT_CDE gt lt Production nit gt lt ProductionUnitOverviewExportRequest gt Example 2 Retrieve the info about a certain production unit lt ProductionUnitOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 lt Production nit gt lt REF_NBR gt 71
90. ortProductionUnit S 29 EXWMA ExportWaterManureAllocation Schema Overview The following table gives for each interface an overview of the document types used as input and the document type obtained as a result Direction Code Name Input XML Schema Name Result XML Schema Name AnimalExportRequest AnimalExport Allows an external application to Retrieve a detailed insight of an animal All characteristics risk status history Retrieve an overview of movements of a certain animal Export S 02 EXAMN ExportAnimalMovementNotificationOverview from to a certain facility AnimalMovementNotificationOverviewExportRequest AnimalMovementNotificationOverviewExport Export Export Export Export Export Export Export EE nin l WIN 2 8 EEE EE IE ME S 215 a ME Pa 2 6 lt E n P F ajaja p an ab ON tA dle n a E 3 n oo Ss 5 So e d T e Z port Import Lo N nm N XFAO EXMVN EXPUO m SUO SLO CHN MWN MVN PPN EXANO ExportAnimalOverview Retrieve an overview of animals and their key characteristics AnimalOverviewExportRequest AnimalOverviewExport Retrieve an overview of changes to a Facility a Sanitary Unit S 04 EXCNO ExportChangeNotificationOverview or Animal characteristics ChangeNotificationOverviewExportRequest ChangeNotificationOverviewExport Retrieve a general overview of facilities name addres
91. ovements on movement level and not on Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportMovementNotificatio nOverview Input Schema MovementNotificationOverviewExportRequest E NOTF_ID long E NOTP_CDE string E NOKD CDE string E MOST CDE string E DTE FRM dateTime E ovementNotificationOverviewExportRequest MovementNotificationOverviewExportRequest T datetime E MovementNotification MovementNotification E DOC NBR on A User smg E LIC PLT string A SecurityToken string E ANTP CDE string A ResultIndex int E ANSB CDE string E PATY CDE TRS string E FCLT CDE string E ZIP string E ANML_REF_NBR string E UPD_DTE_FRM dateTime E UPD DTE TO dateTime http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationOverviewExportRequestSchema XML Example s Example EXAMN 1 Retrieve all movements of a certain animal in a certain period lt MovementNotificationOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt lt MovementNotification gt lt DTE_FRM gt 2004 01 01T00 00 00 lt DTE_FRM gt lt DTE_TO gt 2099 01 01T00 00 00 lt DTE_TO gt lt ANML_REF_NBR gt NL456453543 lt ANML_REF_NBR gt lt MovementNotification gt MovementNotificationOverviewExportRequest Example EXAMN 2 Retrieve all
92. pe blank Actually it is At that moment there is no extra web service security Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 106 Frequently Asked Questions 1 Q Can we still use the old Sanitrace Beltrace numbers A Yes you can however there 1s still a small change The new Beltrace Sanitrace makes the difference between Liable Party and Facility more explicitly E g Transporters Submittors and Owners refer to Parties Farms where the animals come from refer to facilities However sometimes a farmer is also the submittor or transporter So you should know his party number and his facility number To minimize the effort needed the application accepts the facility number as a party number too However in the export of data the correct numbers will be used 2 Q What about foreign transporters or private persons Are they in the system A The best way is to first have a look in the system search by name realm register number and if they are not there create a new party using Simple Party Maintenance the party than generated will have an S000X X XX number and this number can be permanently used for referring to this party 3 Q A few of these persons already have a 9 digit zero prefixed FAVV BOOD KBO number Can I use that number A Unfortunately it is not possible to use this number yet as in the Sanitrace application there still can be multiple parties linked to the same FAVV BOOD KBO number Howev
93. raceRepository SanitraceServices AnimalMovementNotificationOverviewExportSchema EAIManual0071117 doc Interface EXANO ExportAnimalOverview Direction Export Purpose Retrieve an overview of animals and their key characteristics E CDE string AMTP CDE string PRLIM REF NBF string FCLT CDE string SAU COE string LIPD DTE FRM dateTime LIPD DTE TO dateTime TRGRE EDE string CDE bb string m E AnimalCverviewExparktRequest AanimalOverviewExportRequest E Animal Animal A User string A SecurityToken string A ResultIndex int m mm Mm Mm mm Mm m Mm Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportAnimalOverview Input Schema AnimalOverviewExportRequest http Sanitrace EAI SanitraceRepository SanitraceServices AnimalOverviewExportRequestSchema XML Example s Example EXANO 1 Retrieve all bovines in a certain Sanitary Unit lt AnimalOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices AnimalOverviewExportRequestSchema User TESTXML SecurityToken N A ResultIndex 0 gt Animal lt ANTP_CDE gt BOV lt ANTP_CDE gt lt SNUN_CDE gt BE12345678 0101 lt SNUN_CDE gt lt Animal gt lt AnimalOverviewExportRequest gt Example EXANO 2 Retrieve all bovines that have been updated changed today AnimalOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServ
94. rection Import Purpose Submit risk notifications laboratory results Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ImportRiskNotification Input Schema RiskNotificationImport e E E NOTP_CDE string E OCR DIE dateTime PSI E REF MER string p s ss E DOC MER string 3 8 o E ANTP_CDE string EXE orco peskcfestior E FCLT CDE string E RiskNotificatio RiskNotiFic ati E SHUM_REF_ HER string A User string E AMNML REF HER string A SecurityToken string E RIOG CDE string Ld E RIIT_CDE string E LEO REF HEF string E RIIM CDE string E LMS REF NOR string E RIST CDE string E SMP REF NDH BAG string E RSST CDE string E CMM string E Party Party E RiskItem RiskItem http Sanitrace EAI SanitraceRepository SanitraceServices RiskNotificationImportSchema XML Example s Todo Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 84 Interface IMTMN ImportTreatmentNotification Direction Import Purpose Submit treatments e g Bluetongue into Sanitrace Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportTreatmentNotificatio Input Schema TreatmentNotificationlmport E rei E NPTP CDE string E CDE string OE T reatmentNotificatio
95. rfacingSvcs GenericXMLHandler ashx or a schema definition like http Sanitrace EAI SanitraceRepository SanitraceServices RiskNotificationImportSchema will look like http Sanitrace EAI SanitraceRepository SanitraceServices RiskNotificationImportSchema http Sanilux EAI SaniluxRepository SaniluxServices RiskNotificationImportSchema The Sanilux naming will also be visible in the schema name 1 6 xmlns http Sanilux EAI SaniluxRepository testing period Lux not yet in production so shared code base with Sanitrace Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 101 Moving to Production All URLs specified contain the word QAS at least once in the URL For production all of the above will remain the same except that the characters qas or QAS need to be replaced by prd or PRD Le http prd sanitrace be int PRD_Sanitrace_ExtInterfacingSves GenericXMLHandler ashx or for Luxembourg http prd sanitrace lu int PRD_Sanilux_ExtInterfacingSves GenericXML Handler ashx For Belgium a very likely scenario will be a migration into the Sanitel application which is currently in production in the slaughterhouses and for the bluetongue registration In that case the URLs become Le http prd sanitrace be int PRD Sanitel ExtInterfacingSvcs GenericXMLHandler ashx In that case the Sanitel naming will also be visible in the schema name Le xmlns http Sanitel EAl SanitelRepository Sanitrace EAI Manual
96. rtSchema lt MovementNotification gt lt NOTP_CDE gt MMDPS lt NOTP_CDE gt OCR Dit 2008 HO Ore 00 00 lt 0CR_DTE gt lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANSB_CDE gt BOV lt ANSB_CDE gt ANM CNT gt 1 lt ANM CNT gt lt ANCO_CDE gt ALIVE lt ANCO_CDE gt lt VRV_IDN_CRD_FLG gt false lt VRV_IDN_CRD_FLG gt sou lt NPTP_CDE gt DLR lt NPTP_CDE gt lt CDE gt BE402979302 lt CDE gt lt Party gt lt Fac lity gt lt NFTP_CDE gt SRC lt NFTP_CDE gt lt CDE gt BE10046880 lt CDE gt lt SNUN_CDE gt BE10046880 0101 lt SNUN_CDE gt sme Animal REF NBR 2BEI6455223 REF NBR gt PPT VRS NBR 2 PPT VRS NBR SLG VGN NBR 100 46880231020 SLG VGN NBR Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc lt Animal gt lt MovementNotification gt lt MovementNotificationImport gt Departure from a farm to Rendac gt lle sato n e lt MovementNotificationImport xmlns xsi http www w3 0rg 2001 XMLSchema instance mins sd bte pur WWwewseobdqueDdq xMIuSehemat Users TES TM xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MovementNotificationImportSchema gt lt MovementNotification gt lt NOTP_CDE gt MMDPD lt NOTP_CDE gt lt OCR DTE gt 2008 10 20T00 s 00 00 lt OCR_DTE gt lt RCY _DTE gt 0001 01 01T00 s AO PAS REK DIES lt ANTP_CDE gt BOV lt ANTP_CDE gt lt ANSB_CDE gt BOV lt ANSB_CDE gt SANDT CDE gt C36 lt ANDT CDE gt lt ANM_CNT gt 1 lt ANM
97. rty Type Specification of Real Register Number Request for New Sanitary Unit Animal Type Request for New Sanitary Unit Request for New Sanitary Unit Description New Responsible EAIManual0071117 doc 70 Interface IMINN ImportinventoryNotification Direction Import Purpose Submit marking inventory results Layout Documentation http gas sanitrace be int OAS Sanitrace ExtInterfacingSvcs SanitraceServices asmx op ImportInventory Notification Input Schema InventoryNotificationImport NOTP CDE string string E E NOKD_CDE string E CDE string E OCR_DTE dateTime nventoryNotificationImport InventoryNotificationImport Gre m ma E InventoryNotification InventoryNotification DOC NER mum A User strin A SecurityToken E ANTP_CDE string B E AMTP CDE ALT string EX ww Marking E FCLT CDE string E mere e E SNUN CDE string Een dl E CMN string E DG Be E Party Party ERE TER I em Marting E CNT decimal REN http Sanitrace EAI SanitraceRepository SanitraceServices InventoryNotificationImportSchema XML Example s lt InventoryNotificationImport User string SecurityToken string xmlns http Sanitrace EAI SanitraceRepository SanitraceServices InventoryNotificationImport gt s1nvenEoOrYNoEI EIE On lt NOTP_CDE gt string lt NOTP_CDE gt lt NOKD_CDE gt string lt NOKD_CDE gt lt OCR_DTE gt dateTime lt OCR_DTE gt lt REF_NBR gt string lt R
98. s infor reference numbers liable party details Retrieve an overview of movements of a certain animal Retrieve a general overview of Parties Name Address Retrieve a general overview of which exploitation units are R Retrieve a detailed insight in a movement involved parties used at which facilities sanitary units info about a sanitary unit Address Sanitary Characteristics Involved Parties Production Unit Info Marking Inventory Capacity Population Inventory Risk Information History ExportSanitaryUnit Information SanitaryUnitExportRequest SanitaryUnitExport Retrieve a general overview of sanitary units and their key ExportSanitaryUnitOverview characteristics SanitaryUnitOverviewExportRequest SanitaryUnitOverviewExport ExportSlaughteringOverview Retrieve summary statistics of slaughtered animals SlaughteringOverviewExportRequest SlaughteringOverviewExport ImportAnimalNotification Submit births or import records AnimalNotificationImport Submit changes on an Animal a Facility a Sanitary Unit or ImportChangeNotification even a Party ChangeNotificationImport Interaction Result Submit assignments of production units exploitation units ImportProductionUnitNotification ProductionUnitNotificationImport Interaction Result to Sanitary Units 0 MRSN EmportRiskNotification Submit risk notifications laboratory results RiskNotificationImport Export Interfaces always have a request document type as input I
99. st FCLT_CDE Sanitary UnitOverview TUST_CDE Party Overview LNGE_CDE Party Overview Request TPH VAT_NBR RLM_RGS_NBR AnimalImport PPPU_CDE New Interface Import Treatment Notification to register Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc DL treatments such as bluetongue Lu Tu 15 2008 30 2008 Extra Documentation Web Service Stub Generation 1 ado May15 2008 15 2008 Jun 4 2008 Cosmetics Erronuously named NOTP ID field has been renamed to NOTF ID impacting the movement XML structures AnimalMovementNotificationOverviewExportRequest AnimalMovementNotificationOverviewExport ChangeNotificationOverviewExportRequest ChangeNotificationOverviewExport MovementNotificationOverviewExportRequest MovementNotificationOverviewExport Jun 10 2008 Improved Example Treatment Notification Aug 10 2008 FAQ Question19 added Agreement Overview Export interface Added Notification Status Import Added Additional geographical fields in Facility San Unit 1 15 Sep 1 2008 PopulationNotificationImport added RetaggingNotificationImport added Sep 17 2008 Oct 1 2008 LiablePartyOverviewExport added NotificationMovementImport extended with VRV data Party Type PATP missing documentation documentation NOST Code IVD gt IVLD ExportSanitaryUnit API Break Replaced the incorrect UPD DTE FRM UPD DTE TO fields to the single UPD DTE field AnimalDisposalType Rendac on Ani
100. tant processes are complemented by physical elements passports and veterinary visits inspections in the field normally will result in an early detection of potential violations So to answer the question Currently there is no enforcement of a certain type of Security Token However we really invite you to consider using one If you think you are ready for it or want to discuss please contact us Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 112 Support Online VIA the online bug feature tracker IssueMaintenancePage aspx General Helpdesk Dirk Vanschoor favv be Technical Issues Kurt Wayenberg 2 eds com Functional Issues Diederik Degryse eds com Gert Stalmans eds com All other Project Issues Hans Wuyts eds com All other Sanitrace Issues Jean Marie Robijns favv be Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 113
101. ther hand this 1s not an online application but a data interchange protocol with trusted party applications so we do can assume some basic validation at the input side 12 Q Is there a manual of the online application Where can I get them A There are three manuals The EAI Manual this one in English only a getting started manual with general application navigation tips In Dutch and French and a functional manual for the Slaughtering functionality Also in Dutch and French In total these manuals add up to over 10 MB so they cannot be easily send around The manuals are distributed during the training and FAVV AFSCA has made them available via the web site too You can find all manuals by clicking the info centre link on the top right side of the application screens 13 Q What integration scenario 1s preferred A As described above both scenario s land 2 Web Service and Secured Streaming are the preferred ones The Web Service has one additional advantage and that 1s that a local object structure can be created rather than working with the XML itself The Streaming has the advantage that you can use scenario 4 to test your stuff first Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 108 14 O What username do we use in the XML How do I get a logon What if I am a systems integrator and not e g a Slaughterhouse A You can use any logon of this Slaughterhouse as long as they exist in the appli
102. tring E LIA STR string E LIA NBR string E LIA BOX string E LIA ZIP string E LIA CTY string E LIA MCP string E LIA CTRY CDE string E LIA TPH string http Sanitrace EAl SanitraceRepository SanitraceServices ProductionUnitOverviewExportSchema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc Interface EXPU ExportProductionUnit Direction Export Purpose Retrieve all Animal allocations to any old or current production unit of a certain facility including the from and the to of these allocations Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportProductionUnit Input Schema ProductionUnitExportRequest E User string Security Token string A sipraductianLInit ProductionUnit E FCLT CDE string E PRLIM REF MER string E DTE FRM dateTime E DTE TO dateTime ResultIndex int OnBehalfRole string OnBehalfEntity string UserLanguage string http Sanitrace EAT SanitraceRepository SanitraceServices ProductionUnitOverviewExportRequestSchema XML Example s Example 1 Retrieve all production unit details of a certain facility over a certain period Includes all animals that were part of Any Production Unit in this Facility In any period overlapping with the specified period ProductionUnitExportRequest xmlnis http Sanitirace BAI SamitraceRepositonry SanitraceServices ProductionUnitExportRequestSchema User TESTXML Security
103. ttp Sanitrace EAI SanitraceRepository SanitraceServices MarkingSeriesOverviewExportRequest Schema User TESTXML SecurityToken N A gt lt MarkingSeries gt SALE DIE FERM 2090910 20999 0990 90 ALC DIE ENG lt ALC Dis HO EE AO 00 lt ALC_DTE_TO gt lt MarkingSeries gt lt MarkingSeriesOverviewExportRequest gt Example EXMS 2 Retrieve all Bovines Prime Earmark BOVM marking series allocated to a certain sanitary unit lt MarkingSeriesOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices MarkingSeriesOverviewExportReguest Schema User TESTXML SecurityToken N A gt lt MarkingSeries gt lt SNUNZCDE BES005260 7429 9 SNYN EDE lt OISN_CDE gt BOVM lt OISN_CDE gt lt MarkingSeries gt lt MarkingSeriesOverviewExportRequest gt Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 58 Example EXMS 3 Retrieve all Bovines Slaughtering Earmark BOVM marking series allocated to a certain sanitary unit MarkingSeriesOverviewExportRequest xmlns http Sanitrace EAI SanitraceRepository SanitraceServices lt MarkingSeries gt lt SNUN_CDE gt BE30052674 0101 lt SNUN_CDE gt lt MarkingSeries gt lt MarkingSeriesOverviewExportRequest gt Output Schema MarkingSeriesOverviewExport BFS MarkingSeriesOverviewExport MarkingSeriesOverviewExport MarkingSeries E Ei A A MarkingSeriesOverviewExportRequestSchema User TESTXML SecurityToken N A gt
104. ty Token security token is hashed with the SHAI SomeSecret v KoBSaBWHAqMCDVzxXGnJi3ejDQ algorithm 7 AES Encrypted A lt USERIXML date SomeSecretAESSaltValue TESTXMLI2008 11 12T12 00 00 Date Time Value time now gt value encrypted encrypted using AES Sn1Qn6B6bUakN2kjztRMjQU7jfwXor0Jg 2 Hashed Security The above security SomeSecret 03En Fm638yxFW4AHISkb7Taz4 Token toke is hashed with the SHAI algorithm 3 Date Based The security token is Some 0 Secret Security Token combined with the key SomeSecret WTpX2lIrjibwiRAOISrkSX4Gzfy0Nufjyb9q MIISVvSU34fRRoPhg 1 Security Token 1s the simplest form and could be easily rolled out 2 Hides this secret from the user 3 And 4 are still quite simple and make the connection already quite secure This should be the targeted average security level 5 6 and 7 are advanced security means making the connection more or less as secure as if you would have installed a special certificate on the PC of this user Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 105 The AES example is based on an EAS encryptor initialized based on the following settings passPhrase PassPhraseToGenerateAnAESPassword saltValue SomeSecretSaltValue hashAl gorti thmz SHAl initVector gucpLaGR KeySize Sizel28 The Salt Value the one you add in the security token Remark that with every XML message the key is incremented Is it an option to leave the Security Token Ty
105. uctionunitNotificationtmport E NOKD_CDE string E PRC REF NBR string E ProductionUnitNotification ProductionUnitNotification E OCR_DTE dateTime E PRC_NAM string A User string B E RCV DTE dateTime B E PRC STR string A SecurityToken string E REF NBR string E PRC NBR string E SNUM CDE string E PRC ZIP string nn Wi E ProductionUnit ProductionUnit E PRC_CTY string E PRC_PATY_CDE string umi http Sanitrace EAI SanitraceRepository SanitraceServices ProductionUnitNotificationImportSchema XML Example s Output Schema Interaction Result See definition Interaction Result Schema Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 81 Interface IMRTN ImportRetaggingNotification Direction Import Purpose Submit Retagging notifications into the system Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ImportR etaggingNotification Input Schema RetaggingNotificationimport RetaggingNotification RetaggingNotification EP Er E NOTP CDE string E NPTP CDE string E NOKD CDE string E CDE string E OCR DTE dateTime RetaggingNotificationImport RetaggingNotificationImport i Stet E RetaggingNotification RetaggingNotification E DOC NBR EC A User string 3 A SecurityToken string E 1 ANT CDE string ga E FCLT_CDE string RetaggingLine RetaggingLine E SNUN_CDE string E ORIM_CDE string E CMN string E ANML_CDE string E
106. urityToken N A ResultIndex 0 gt EE ode wom n IE lt PRUN_REF_NBR gt 123456789 lt PRUN_REF_NBR gt lt DTE_FRM gt 2006 12 01T00 EU EE DENON Se EE lt Production nit gt lt Product LonUMIt Export Request gt Output Schema ProductionUnitExport http Sanitrace EAI SanitraceRepository SanitraceServices Production UnitExportSchema La F ProductionUnit ProductionUnit E ProductionUnitExport ProductionUnitExport PRUN_REF_MBR string E ProductionUnit Production nit SNUN_CDE string A User string FCLT_CDE string A SecurityToken string amp RML_REF_NER string A ReturnTode string RSP EXT REF HER string A ReturnMessage string DTE IN dateTime DTE CUT dateTime Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 50 Interface EXSU ExportSanitaryUnit Direction Export Purpose Retrieve detailed info about a sanitary unit Location Address Sanitary Characteristics Involved Parties Production Unit Info Marking Inventory Capacity Population Inventory Risk Information History Information Layout Documentation http qas sanitrace be int QAS Sanitrace ExtInterfacineSvcs SanitraceServices asmx op ExportSanitarvUnit Input Schema SanitaryUnitExportRequest SanitaryUnitExportRequest SanitaryUnitExportRequest E SanitaryUnit SanitaryUnit A User string E E CDE string A SecurityToken string A ResultIndex int http Sanitrace EAI SanitraceRepository SanitraceServices Sanitary UnitExportR
107. vironments such as Net or Java can reference the asmx file and generate WebService stubs in your development environment After that you can code using direct access of the XML structures Sanitrace EAI Manual Draft v 1 5 EAIManual0071117 doc 94 Publishing web services as an asmx has some additional advantages First it 1s very convenient to get insight in to the XML input and output structure and get a basis to start from Just click on a method e g Export Animal Overview Sanitrace_SanitraceServices Click here for a complete list of operations Test The test form is only available for requests from the local machine SOAP 1 1 The following is a sample SOAP 1 1 request and response The placeholders shown need to E POST int 0AhS Sanitrace ExtInterfacingSvcsa SanitraceServices asmx H Host dqas sanitrace be Content Type text xml charset utf S Content Length length SOAP ction http Sanitrace EAI SanitraceRepositorv SanitraceServ lt xml version 1 0 encoding utrf a zanap Envelope xmlns xsi http www w3 org z 0gi XMLSchema instance zsoap Body lt Export inimalCrerview xmlns http Sanitrace E I SanitraceRepo lt AnimalOveryvyiewExportRequest User string SecurityToken str lt Ainimal xmlns http Sanitrace E I SanitraceRepository San zCDE string CDE lt ANTP CDE stringz ANTP CDE lt PRUN REF NBR stringc PRUN REF NBR gt lt FCLT CDE gt string lt FCLT CDE lt SNUN CDE stringc SNUM CDE I
108. with XX the schema number as defined in the table underneath schema31 schema25 schema2 schema28 schema6 schema34 schema23 schema26 schema29 schema32 schema35 schema38 schema41 schema44 schema47 schema50 schema53 schema37 schema9 schema43 schema12 schema40 schema46 schema15 schema18 schema49 schema21 Sanitrace EAI Manual Draft v 1 5 AnimalExport AnimalMovementNotificationOverviewExport AnimalNotificationImport AnimalOverviewExport ChangeNotificationImport ChangeNotificationOverviewExport ExportAnimalMovementNotificationOverviewRequest ExportAnimalOverviewRequest ExportAnimalRequest ExportChangeNotificationOverviewRequest ExportFacilityOverviewRequest ExportMovementNotificationOverviewRequest ExportMovementNotificationRequest ExportPartyOverviewRequest ExportProductionUnitOverviewRequest ExportSanitaryUnitOverviewRequest ExportSanitaryUnitRequest FacilityOverviewExport InventoryNotificationImport MovementNotificationExport MovementNotificationImport MovementNotificationOverviewExport PartyOverviewExport PopulationNotificationImport ProductionUnitNotificationlmport ProductionUnitOverviewExport RiskNotificationImport EAIManual0071117 doc 96 The zip file underneath gives a Net example on how to make calls to the Web Service Package Since Microsoft Patch 928365 the behavior of the XSD tool is definitively prohibiting the use of anonymous types System Xml Serialization Xml ypeAttribute Ano
Download Pdf Manuals
Related Search
Interfaces interfaces interfaces meaning interfaces in java interfaces c# interfaces synonyms interfaces in typescript interfaces in c++ interfaces en java interfaces vs abstract classes interfaces de red interfaces de usuario interfaces de audio interfaces linux interfaces significado interfaces journal interfaces en python interfaces and free boundaries interfaces cerebro computadora interfaces in crystalline materials
Related Contents
Samsung SyncMaster 2443BW Line Drive Service Manual - Revised 9-24 MAXREPAIR ® Guide d`installation et d`utilisation Xerox WorkCentre 4250/4260 Brochure User Guide - CNET Content Solutions Gigabyte GC-WB867D-I bedienungsanleitung 6182-9U Toughcopter IM Fr Copyright © All rights reserved.
Failed to retrieve file