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.
|
|
CertType | One 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 1409 af 26/09/2020
- 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 21001:2020
- DS/OHSAS 18001:2008
- ECM
- ECM förordningen EU 445/2011
- ECM, (EU) 2019/779
- ECM, förordningen (EU) 2019/779
- ECM, regulation (EU) 2019/779
- EMAS
- EN 1090-1:2009+A1:2011
- EN 14351-1:2006+A2:2016
- EN 15085-2:2007
- EN 15085-2:2020
- EN 15085-4:2007
- EN 15224:2012
- EN 15224:2017
- EN 16034:2014
- 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 15378:2017
- ISO 18295-1:2017
- ISO 20121:2012
- ISO 20400:2017
- ISO 22000:2005
- ISO 22000:2019
- ISO 22001:2019
- ISO 22301:2014
- ISO 22301:2019
- ISO 26000:2010
- ISO 26000:2021
- ISO 3834-2:2005
- ISO 3834-2:2021
- ISO 3834-3:2005
- ISO 3834-3:2021
- ISO 3834-4:2005
- ISO 3834-4:2021
- ISO 39001:2012
- ISO 44001:2017
- ISO 44001:2017/NA
- ISO 45001:2018
- ISO 45001:2023
- ISO 50001:2011
- ISO 50001:2018
- 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/IEC 27001:2022
- ISO/IEC 27001:2023
- 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
|
| CertificateNumber | The 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. |
| LanguageCode | A 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. |
| DateIssued | The 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. |
| PostalCode | Postal 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. |