Babacus

Navigation

Babacus Export Tool
Writing SQL queries
SQL field specification
Babacus Web Service

Connecting to the Babacus Web Service

Some Certificate Authorities (CAs) may prefer to transfer certificate information to the Babacus web service directly. To accomplish this, Babacus publishes a SOAP Web Service, located here. There are many ways to write code working against a SOAP Web Service: a recommended method is to use the support present in the Microsoft .NET Framework and Microsoft Visual Studio.NET.

The web service has two methods: Login and UploadCertificates. Login must be called first, with a username and password supplied by Babacus. Login returns a session string, which must be used subsequent calls to UploadCertificates.

UploadCertificates takes as parameters a session string, an flag indicating whether the transfer is for testing purposes only, or whether the data transmitted should actually be saved to the Babacus database, an array of UploadedCertificates and an array of UploadedSiteMonikers.

The site monikers are optional entities intended to support the notion of site aliases, or alternative unique identifiers for certified sites. An example of an alternate unique identifier system is HSA-ID, developed and used by Swedish County Councils (Landsting). Support for the site monikers is not required unless the CA intends to transmit HSA-IDs or similar site aliases.

public class UploadedCertificate
{
        public string CertId;                   // REQUIRED
        public string CertType;                 // REQUIRED
        public string CertificateNumber;        
        public string Division;                 
        public string DivisionEn;               
        public string Scope;                    
        public string ScopeEn;   
        public string Limitations;
        public string LimitationsEn;               
        public string LanguageCode;             
        public bool Disabled;                   
        public string AccreditationBody;        
        public UploadedSite_v2_0 Site;          // REQUIRED
        public DateTime DateIssued;             // REQUIRED		
        public DateTime DateExpired;
}

CAs should transmit as many of these fields as possible. Records with missing REQUIRED fields will be rejected forthwith.

CertId A unique identifier for the certification. Preferrably it is the certificate number of the certification in question. At the very least, it is a primary key column in a table in the CA database. For proper operation, the certification IDs are expected to be unique for each issued certification, and persistent from one import to the next. If multiple sites have been certified with the same certification, the sites should all have the same certID.
CertTypeOne of the following certificates [Note: if a specific certificate is missing, please contact Babacus]
  • 2003/87/EC
  • 93/42/EEC
  • 97/23/EC
  • AFS 2001:1
  • AFS 2017:3
  • ANSI/ESD S20.20-2007
  • AQAP 2110
  • AQAP 2120
  • AS/EN/JISQ 9100
  • AS9120A
  • ASC
  • BEK nr 1191 af 09/10/2013
  • BEK nr 1510 af 14/12/2018
  • BF9K
  • BRC - IoP Packaging
  • BRC - Consumer
  • BRC - Storage and Distribution
  • BRC - Food
  • CEN/TS 16555-1:2013
  • Codex HACCP
  • DS/OHSAS 18001:2008
  • ECM
  • EMAS
  • EN 1090-1:2009+A1:2011
  • EN 15085-2:2007
  • EN 15085-4:2007
  • EN 15224:2012
  • EN 15224:2017
  • EN 9120:2009
  • EN 9120:2010
  • EPD
  • The Flower
  • FAMI-QS
  • FHV-Kravdokument
  • FR2000
  • FSC
  • FSSC 22000
  • GMP+
  • Grundcertifiering Gris
  • GTP
  • HACCP FS System
  • IATF 16949:2016
  • IFS
  • IFS - Logistics
  • IP Livsmedel
  • Swedish Seal
  • IRIS
  • ISO 12647-2:2016
  • ISO 13485:2003
  • ISO 13485:2012
  • ISO 13485:2016
  • ISO 14001:2004
  • ISO 14001:2015
  • ISO 15378:2011
  • ISO 15378:2015
  • ISO 20121:2012
  • ISO 20400:2017
  • ISO 22000:2005
  • ISO 22301:2014
  • ISO 26000:2010
  • ISO 3834-2:2005
  • ISO 3834-3:2005
  • ISO 3834-4:2005
  • ISO 39001:2012
  • ISO 44001:2017
  • ISO 45001:2018
  • ISO 50001:2011
  • ISO 55000:2014
  • ISO 9001:2008
  • ISO 9001:2015
  • ISO/IEC 17025:2017
  • ISO/IEC 20000-1:2011
  • ISO/IEC 27001:2005
  • ISO/IEC 27001:2006
  • ISO/IEC 27001:2013
  • ISO/IEC 27001:2014
  • ISO/IEC 27001:2017
  • ISO/TS 16949:2002
  • ISO/TS 16949:2009
  • KBA
  • Keymark
  • KRAV
  • MDSAP
  • MSC
  • NFS 2005:10
  • OHSAS 18001:2007
  • PEFC
  • Povel
  • PS 9000:2011
  • Responsible Care
  • REVAQ
  • RSB
  • SCC 2008/5.1
  • Smart-Quality
  • Smart-Environment
  • Smart-SAM
  • Swedish Environmental Base
  • TickIT
  • TickITplus
  • TL 9000
  • Tryggare Mat
  • VDA 6.1
  • VDA 6.4:2005
  • WLA-SCS:2006
CertificateNumberThe certificate number of the certification. The certification number is only used for presentation. It may differ from site to site when multiple sites have a common certification. In this case the certID must be the same for all sites.
Division
DivisionEn
The division, department, subunit or similar of a parent organization.
Scope
ScopeEn
The scope of the certification in a national language and in English respectively.
LanguageCodeA language/culture identifier as specified in RFC 4646. A list of languages can be found here. For example, Swedish is represented by the code sv-SE, Danish is represented by da-DK and (UK) English as en-GB.
Limitations
LimitationsEn
Limitations or exclusions applied to the certification.
DateIssuedThe date when the certification was issued.
DateExpired The date when the certification is due to expire (or did expire). The date information is only used for statistical purposes. Individual issue or expiry dates are never displayed.

public class UploadedSite
{
    public string SiteId;               // REQUIRED					
    public string SiteName;             // REQUIRED
    public string OrganizationNumber;   
    public string VisitingAddress;
    public string VisitingCity;
    public string PostalCode;
    public string ContactEmail;	
    public string CountryCode;
}
SiteId A unique identifier for the site in question.
SiteName The name of the company or organization to which the certificate is awarded.
OrganizationNumber A unique ID for the organization, often issued by the government of the country in which the organization operates. In Sweden this value should be the "organisationsnummer" of the organization in question.
ContactEmail Address of the CA contact person at the certified company.
VisitingAddress The physical street address of the site.
VisitingCity The city in which the site is located.
PostalCodePostal code for the site.
CountryCode ISO 3166 code for the country in which the site is located specified as a two-character country code. For instance, the codes for Sweden, Norway, and Finland are SE, NO, and FI, respectively.
Do not confuse country codes with culture codes! The ISO 3166 country code "SE" (Sweden) is not the same as the RFC 4646 culture code"sv-SE" (the Swedish language spoken in Sweden).
public class UploadedSiteMoniker
{
    public string siteId;               // REQUIRED
    public string type;                 // REQUIRED
    public string id;                   // REQUIRED
    public string ExtraData;
}
siteId The CA-specific unique site identifier, as specified in the UploadedSite above. Records from the result of a site alias query that contain Site IDs not appearing in the result from the certificate query will be rejected with a diagnostic message.
aliasType The type of alias or alternative site identifier. Currently, the only supported type of alias is HSA-ID.
aliasId The alternative site identifier. For example, the record for a site with a valid HSA-ID would have an aliasId similar to "SE2321000016-10N6" (quotes not included).
ExtraData Reserved for future use. Do not pass any data in this field.

© Copyright Babacus AB 2004-2019