Puerto Rico Business Entity API: Vollständiger Entwicklerleitfaden
Puerto Rico nimmt als nicht inkorporiertes US-Territorium eine besondere Stellung im amerikanischen Unternehmensrecht ein. Für deutsche und europäische Compliance-Teams, die geschäftliche Beziehungen mit US-amerikanischen Gegenparteien prüfen müssen, stellt Puerto Rico häufig eine blinde Fleck dar – denn die Insel verfügt über eigene Handelsregisterstrukturen, die sich von den US-Bundesstaaten unterscheiden. Dennoch gelten hier dieselben KYB-Sorgfaltspflichten wie bei jeder anderen US-Jurisdiktion. Die Puerto Rico Business Entity API von OpenSOSData schließt diese Lücke und ermöglicht automatisierte, regulierungskonforme Unternehmensverifizierungen in Echtzeit.
Dieser Leitfaden richtet sich an Entwickler und Compliance-Verantwortliche in Deutschland und der EU, die eine skalierbare Lösung für die Prüfung puerto-ricanischer Geschäftsentitäten in ihre KYB-Workflows integrieren möchten.
Warum Puerto Rico für EU-Unternehmen relevant ist
Viele europäische Unternehmen unterschätzen die Häufigkeit, mit der sie auf puerto-ricanische Gesellschaften stoßen. Pharmaunternehmen, Logistikdienstleister, Finanzinstitutionen und Technologiekonzerne nutzen Puerto Rico aufgrund seiner Steuervorteile – insbesondere der Acts 20, 22 und 60 – als bevorzugten Standort für Tochtergesellschaften. Wer mit einem US-amerikanischen Partner verhandelt, kann daher schnell auf eine Gesellschaft stoßen, die beim Puerto Rico Department of State registriert ist.
Für Unternehmen, die der deutschen Geldwäschegesetz-Pflicht (GwG) unterliegen oder unter den Anforderungen der EU-Geldwäscherichtlinie AMLD6 arbeiten, bedeutet das: Eine vollständige Know-Your-Business-Prüfung muss auch diese Jurisdiktion abdecken. Eine manuelle Recherche im puerto-ricanischen Online-Portal ist zeitaufwändig, fehleranfällig und nicht automatisierbar – die API-Integration ist daher der professionelle Standard.
Regulatorischer Rahmen: GwG, AMLD6 und DSGVO
Deutsche GwG-Pflichten bei US-Gegenparteien
Das deutsche Geldwäschegesetz verpflichtet Verpflichtete – darunter Kreditinstitute, Zahlungsdienstleister, Rechtsanwälte und Wirtschaftsprüfer – zur Identifizierung und Verifizierung von Vertragspartnern. Bei juristischen Personen umfasst dies die Feststellung des Namens, der Rechtsform, des Sitzes sowie des wirtschaftlich Berechtigten. Eine API-gestützte Abfrage des Secretary-of-State-Äquivalents in Puerto Rico liefert genau diese strukturierten Daten automatisiert.
EU AMLD6 und transatlantische Sorgfaltspflichten
Die 6. EU-Geldwäscherichtlinie (AMLD6) erweitert den Katalog der Vortaten zur Geldwäsche und verschärft die Haftung für juristische Personen. Für Unternehmen mit US-Geschäftsbeziehungen bedeutet das: Die Enhanced Due Diligence bei risikoreichen Gegenparteien erfordert verifizierbare, aktuelle Registrierungsdaten – nicht nur eine Selbstauskunft des Geschäftspartners.
DSGVO-Konformität bei US-Unternehmensdaten
Ein häufiges Missverständnis: Öffentlich zugängliche Registerdaten aus dem Secretary of State fallen nicht unter den Schutzbereich der DSGVO, soweit sie ausschließlich juristische Personen und deren Handelsregistereintragungen betreffen. Die Abfrage von Entitätsnamen, Registrierungsnummern und Registered-Agent-Adressen ist DSGVO-neutral, sofern keine natürlichen Personen als Datenobjekte betroffen sind. Bei Einzelunternehmen und Personengesellschaften ist jedoch Vorsicht geboten und eine Rechtsgrundlage nach Art. 6 DSGVO erforderlich.
Entitäten ab $0,10 pro Abfrage verifizieren
Live-Abfragen ab $0,10, mit Volumen bis zu $0,0314. Nutzungsbasierte Abrechnung.
Kostenloses Konto erstellenOpenSOSData: Technische Grundlagen der Puerto Rico Business Entity API
OpenSOSData bietet eine einheitliche REST-API für alle 50 US-Bundesstaaten sowie Washington D.C., Puerto Rico und die U.S. Virgin Islands – insgesamt über 34 Millionen Entitäten. Die Integration von Puerto Rico erfolgt über denselben Endpunkt wie alle anderen Jurisdiktionen, was die Implementierung erheblich vereinfacht.
API-Endpunkt und Parameter
Alle Anfragen werden als HTTP POST an folgenden Endpunkt gesendet:
POST https://api.opensosdata.com/v1/lookup
Der wichtigste Steuerparameter ist cache_preference, der drei Werte annehmen kann:
- live_only: Direktabfrage beim puerto-ricanischen Register – aktuelle Daten, höhere Kosten
- cache_first: Cached-Daten bevorzugt, bei Cache-Miss Live-Abfrage
- cache_only: Ausschließlich gecachte Daten – schnell und kostengünstig
Preisstruktur
Die API arbeitet auf Pay-as-you-go-Basis ohne Mindestabnahme. Live-Abfragen kosten $0,10 pro Anfrage (ca. €0,09), bei hohem Volumen sinkt der Preis auf $0,0314. Gecachte Abfragen starten bei $0,01 und sind ab großen Volumen für $0,00314 erhältlich. Dies macht die Lösung sowohl für gelegentliche Compliance-Prüfungen als auch für hochvolumige automatisierte Onboarding-Prozesse wirtschaftlich attraktiv.
Praktisches Code-Beispiel: Python-Integration
Das folgende Python-Beispiel zeigt eine vollständige Abfrage einer puerto-ricanischen Geschäftsentität. Es eignet sich für die Integration in bestehende KYB-Pipelines oder Django/FastAPI-Backend-Systeme.
import requests
import json
# API-Konfiguration – API-Key aus Umgebungsvariable laden
import os
API_KEY = os.environ.get("OPENSOSDATA_API_KEY")
API_URL = "https://api.opensosdata.com/v1/lookup"
def pruefe_puerto_rico_unternehmen(unternehmensname: str, live: bool = True) -> dict:
"""
Prüft ein Unternehmen im puerto-ricanischen Handelsregister.
Args:
unternehmensname: Name der zu prüfenden Gesellschaft
live: True für Live-Abfrage (aktuell), False für Cache (schneller)
Returns:
Wörterbuch mit Registerdaten oder Fehlermeldung
"""
# Cache-Präferenz basierend auf Compliance-Anforderung wählen
# Für GwG-Pflichten empfehlen wir live_only für aktuelle Statusinformationen
cache_einstellung = "live_only" if live else "cache_first"
# Anfrage-Payload zusammenstellen
payload = {
"state": "PR", # Puerto Rico Jurisdiktionscode
"company_name": unternehmensname,
"cache_preference": cache_einstellung # WICHTIG: nicht 'lookup_type' verwenden
}
# HTTP-Header mit Authentifizierung
headers = {
"x-api-key": API_KEY,
"Content-Type": "application/json",
"Accept": "application/json"
}
try:
# API-Anfrage senden (Timeout: 30 Sekunden)
antwort = requests.post(
API_URL,
headers=headers,
json=payload,
timeout=30
)
antwort.raise_for_status()
ergebnis = antwort.json()
# Ergebnisse für Compliance-Protokoll aufbereiten
if ergebnis.get("entities"):
erste_entitaet = ergebnis["entities"][0]
print(f"✓ Unternehmen gefunden: {erste_entitaet.get('entity_name')}")
print(f" Rechtsform: {erste_entitaet.get('entity_type')}")
print(f" Registrier-ID: {erste_entitaet.get('entity_id')}")
print(f" Status: {erste_entitaet.get('status')}")
print(f" Gründungsdatum: {erste_entitaet.get('formation_date')}")
print(f" Reg. Agent: {erste_entitaet.get('registered_agent')}")
print(f" Agent-Adresse: {erste_entitaet.get('registered_agent_address')}")
else:
print("⚠ Keine Einträge gefunden – manuelle Prüfung erforderlich")
return ergebnis
except requests.exceptions.HTTPError as fehler:
print(f"✗ HTTP-Fehler: {fehler}")
return {"error": str(fehler)}
except requests.exceptions.Timeout:
print("✗ Zeitüberschreitung – bitte erneut versuchen")
return {"error": "timeout"}
# Beispielaufruf für KYB-Onboarding-Prozess
if __name__ == "__main__":
# Typisches Szenario: Neue Geschäftsbeziehung mit puerto-ricanischer Gesellschaft
ergebnis = pruefe_puerto_rico_unternehmen(
unternehmensname="Example Pharma Solutions LLC",
live=True # Live-Abfrage für GwG-Compliance
)
# JSON-Ausgabe für Audit-Trail speichern
print("\n--- Vollständiges API-Ergebnis (für Compliance-Akte) ---")
print(json.dumps(ergebnis, indent=2, ensure_ascii=False))
Vergleichstabelle: Handelsregister vs. Puerto Rico Secretary of State API
| Merkmal | Deutsches Handelsregister | Puerto Rico (via OpenSOSData API) |
|---|---|---|
| Zugang | Handelsregister.de, kostenpflichtig | REST-API, Pay-as-you-go |
| Automatisierbarkeit | Eingeschränkt (kein offizieller API-Standard) | Vollständig automatisierbar |
| Antwortfelder | Handelsname, Sitz, Geschäftsführer, Bilanzen | Name, Typ, ID, Status, Gründungsdatum, Registered Agent |
| Kosten pro Abfrage | €4,50 – €8,00 (Amtsgericht) | $0,01 – $0,10 (~€0,009 – €0,09) |
| Aktualität | Wenige Tage Verzug möglich | Live oder gecacht (wählbar) |
| Abdeckung US-Territorien | Nicht verfügbar | 50 Staaten + DC, PR, USVI |
Integration in bestehende Compliance-Workflows
Für Unternehmen, die bereits ein KYB-System betreiben – sei es eine eigenentwickelte Plattform oder ein Drittanbieter-Tool – lässt sich die OpenSOSData API als Datenanreicherungsschicht integrieren. Typische Anwendungsfälle umfassen das automatische Onboarding neuer Lieferanten, die Überwachung von Statusänderungen bei Bestandspartnern sowie die Vorbereitung von Transaktionsberichten für BaFin oder die FIU.
Die vollständige API-Dokumentation sowie Beispiele für weitere Sprachen (Node.js, Java, PHP) finden Sie unter opensosdata.com/docs/. Einen kostenlosen API-Schlüssel erhalten Sie nach Registrierung unter app.opensosdata.com.
Häufig gestellte Fragen (FAQ)
Warum brauche ich eine spezielle API für Puerto Rico – ist die Insel nicht Teil der USA?
Puerto Rico ist ein nicht inkorporiertes US-Territorium mit eigener Gesetzgebung und eigenem Unternehmensregister beim Puerto Rico Department of State. Gesellschaften, die dort gegründet wurden, erscheinen nicht in den Secretary-of-State-Datenbanken der US-Bundesstaaten. OpenSOSData aggregiert Puerto Rico als eigenständige Jurisdiktion mit dem Code „PR" – genauso wie Delaware oder New York – und macht sie über eine einheitliche API zugänglich.
Welche Datenfelder liefert die API für puerto-ricanische Entitäten?
Die API gibt strukturierte JSON-Daten zurück, darunter: Unternehmensname (entity_name), Rechtsform (entity_type), Registrierungsnummer (entity_id), aktueller Status (z. B. „Active", „Inactive"), Gründungsdatum (formation_date), sowie Name und Adresse des Registered Agent. Diese Felder decken die Mindestanforderungen der GwG-Identifizierungspflicht für juristische Personen ab.
Wie unterscheiden sich live_only und cache_first für Compliance-Zwecke?
Für regulatorische Prüfungen – insbesondere bei der Begründung neuer Geschäftsbeziehungen nach §10 GwG – empfehlen wir live_only, da hier tagesaktuelle Daten direkt aus dem Register abgerufen werden. cache_first eignet sich für Batch-Screenings oder Hintergrundüberwachungen, bei denen eine geringfügige Datenverzögerung akzeptabel ist. Die Wahl hat direkte Auswirkung auf Kosten und Latenz.
Ist die Nutzung der API DSGVO-konform?
Die Abfrage von Registerdaten juristischer Personen (GmbH-Äquivalente, Corporations, LLCs) ist grundsätzlich DSGVO-neutral, da keine personenbezogenen Daten natürlicher Personen im datenschutzrechtlichen Sinne verarbeitet werden. Handelt es sich jedoch um Einzelunternehmer oder Personengesellschaften mit namentlich bekannten Inhabern, ist eine Rechtsgrundlage nach Art. 6 Abs. 1 DSGVO erforderlich – in der Regel das berechtigte Interesse (lit. f) im Rahmen der gesetzlichen Sorgfaltspflichten.
Welche Preise gelten für die Puerto Rico API?
Es gibt keine jurisdiktionsspezifische Preisgestaltung. Live-Abfragen kosten $0,10 pro Request (bei Volumen ab $0,0314), gecachte Abfragen $0,01 (ab $0,00314 bei hohem Volumen). Das Modell ist Pay-as-you-go ohne Mindestabnahme oder Abonnementgebühren. Für Unternehmen mit regelmäßigen Compliance-Prüfungen empfiehlt sich ein Blick auf die Volumenpreise unter opensosdata.com.
Kann ich die API für Batch-Screenings ganzer Lieferantenlisten nutzen?
Ja. Die API ist auf parallele Anfragen ausgelegt. Für große Batches empfehlen wir asynchrone HTTP-Requests mit einer Ratenbegrenzung gemäß den in der Dokumentation angegebenen Limits. Als Cache-Präferenz bietet sich cache_first an, um Kosten zu optimieren, während bei Statusänderungs-Alerts live_only bevorzugt werden sollte.
Wie registriere ich mich und erhalte einen API-Schlüssel?
Die Registrierung erfolgt unter app.opensosdata.com. Nach der Kontoerstellung wird ein API-Schlüssel bereitgestellt, der als Bearer-Token im Authorization-Header verwendet wird. Es ist keine Kreditkarte für das Testkonto erforderlich. Für den Produktionsbetrieb empfehlen wir, den Schlüssel als Umgebungsvariable zu speichern und niemals im Quellcode zu hinterlegen.
Fazit
Die Puerto Rico Business Entity API von OpenSOSData ist für deutsche und europäische Compliance-Teams eine unverzichtbare Ergänzung ihrer KYB-Infrastruktur. Sie schließt eine Jurisdiktionslücke, die in manuellen Prozessen häufig übersehen wird, und erfüllt die Datenanforderungen der GwG sowie der EU-Geldwäscherichtlinien. Mit transparenten Pay-as-you-go-Preisen, einer einfachen REST-Schnittstelle und vollständiger Abdeckung aller US-Territorien bietet OpenSOSData die technische Grundlage für regulierungskonforme, skalierbare Unternehmensverifizierung.
Starten Sie noch heute unter app.opensosdata.com und integrieren Sie Puerto Rico in Ihren KYB-Workflow – in weniger als einer Stunde einsatzbereit.