Maersk (nezávislý vydavatel) (Preview)

Vlastní konektor pro expediční data Maersk, včetně umístění, plavidel, plánů a portů. Jedná se o veřejná referenční data.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Dan Romano
Email	dan.romano@swolcat.com

Metadata konektoru
Vydavatel	Dan Romano
Internetová stránka	https://developer.maersk.com/api-catalogue
Zásady ochrany osobních údajů	https://terms.maersk.com/privacy
Kategorie	Data

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Klíč rozhraní API	securestring	Klíč rozhraní API	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Získání aktivních portů	Vrátí seznam aktivních portů zátěžových nebo výstupních prostředků, které volal A.P. Moller-Maersk plavidla A/S.
Získání informací o plavidlech	Vrátí seznam aktivních plavidel provozovaných společností A.P. Moller-Maersk A/S.
Získání konečných termínů zásilky	Vrátí seznam konečných termínů zásilek na terminál pro dané plavidlo/plavbu/přístav nákladu.
Získání plánů plavidel podle plavidla	Vrátí plány volání přístavu plavidla pro dané plavidlo a filtry plavby.
Získání plánů plavidel podle přístavu	Vrátí plánovaná volání portů pro poskytnuté filtry.
Získání polohy dopravce podle geografického ID	Vrátí seznam umístění podle geografického ID.
Získání seznamu umístění	Vrátí seznam umístění podporovaných maerskem.

Získání aktivních portů

ID operace:

GetActivePorts

Vrátí seznam aktivních portů zátěžových nebo výstupních prostředků, které volal A.P. Moller-Maersk plavidla A/S.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Kódy dopravce	carrierCodes	True	string	Jeden nebo více kódů dopravce (např. MAEU). Čárkami oddělené, pokud je násobek.
Kódy zemí	countryCodes		string	Volitelné kódy zemí ISO 3166-1 alfa-2 (např. USA, CN)

Návraty

response

array of Port

Získání informací o plavidlech

ID operace:

GetVessels

Vrátí seznam aktivních plavidel provozovaných společností A.P. Moller-Maersk A/S.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Čísla plavidel IMO	vesselIMONumbers		string	Čísla IMO oddělená čárkami (např. "93329999,9458030")
Kódy plavidla dopravce	carrierVesselCodes		string	Čárkami oddělený seznam hodnot (např. "93329999 9458030")

Návraty

response

array of Vessel

Získání konečných termínů zásilky

ID operace:

GetDeadlines

Vrátí seznam konečných termínů zásilek na terminál pro dané plavidlo/plavbu/přístav nákladu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Kód země ISO	ISOCountryCode	True	string	Kód země ISO portu (např. USA)
Port načtení	portOfLoad	True	string	Název města nebo portu (např. Houston)
Číslo IMO plavidla	vesselIMONumber	True	string	Číslo IMO plavidla
Cesta	voyage	True	string	Číslo cesty (např. 010E)

Návraty

response

array of ShipmentDeadline

Získání plánů plavidel podle plavidla

ID operace:

GetSchedulesByVessel

Vrátí plány volání přístavu plavidla pro dané plavidlo a filtry plavby.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo IMO plavidla	vesselIMONumber		string	7místné číslo IMO pro plavidlo
Nosný kód plavidla	carrierVesselCode		string	3znakový kód plavidla Maersk
Datum zahájení	startDate		date	Počáteční datum plánu
Časové období	dateRange		string	Rozsah od počátečního data
Kódy dopravce	carrierCodes	True	string	Kódy dopravce vyžadované Maerskem

Návraty

Body

VesselSchedule

Získání plánů plavidel podle přístavu

ID operace:

GetSchedulesByPort

Vrátí plánovaná volání portů pro poskytnuté filtry.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Kód umístění UN	UNLocationCode		string	Kód umístění ORGANIZACE SPOJENÝCH NÁRODŮ pro port (např. USHOU). Vyžaduje se, pokud nejsou zadané cityName a carrierGeoID.
Název města	cityName		string	Název města přístavu. Vyžaduje se, pokud nejsou zadané UNLocationCode a carrierGeoID.
Geografické ID operátora	carrierGeoID		string	Identifikátor interního umístění Maersk. Vyžaduje se, pokud nejsou zadané hodnoty UNLocationCode a cityName.
Datum zahájení	startDate		date	Počáteční datum plánu portů
Časové období	dateRange		string	Rozsah od počátečního data
Kódy dopravce	carrierCodes	True	string	Požadované kódy dopravce

Návraty

Body

PortSchedule

Získání polohy dopravce podle geografického ID

ID operace:

GetCarrierLocationByGeoID

Vrátí seznam umístění podle geografického ID.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Geografické ID operátora	carrierGeoID	True	string	Geografické ID dopravce Maersk

Návraty

Body

CarrierLocation

Získání seznamu umístění

ID operace:

GetLocations

Vrátí seznam umístění podporovaných maerskem.

Návraty

response

array of Location

Definice

Umístění

Name	Cesta	Typ	Description
kód země	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName	locationName	string
carrierGeoID	carrierGeoID	string
UNRegionCode	UNRegionCode	string
UNRegionName	UNRegionName	string

CarrierLocation

Name	Cesta	Typ	Description
kód země	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName	locationName	string
carrierGeoID	carrierGeoID	string
carrierRkstCode	carrierRkstCode	string
carrierRktsCode	carrierRktsCode	string
ID časového pásma	timeZoneID	string
carrierCountryGeoID	carrierCountryGeoID	string
UNLocationCode	UNLocationCode	string
UNRegionCode	UNRegionCode	string
UNRegionName	UNRegionName	string

Loď

Name	Cesta	Typ	Description
vesselIMONumber	vesselIMONumber	string
carrierVesselCode	carrierVesselCode	string
název plavidla	vesselName	string
vesselFlagCode	vesselFlagCode	string
vesselCallSign	vesselCallSign	string

Přístav

Name	Cesta	Typ	Description
kód země	countryCode	string
countryName	countryName	string
UNLocationCode	UNLocationCode	string
cityName	cityName	string
název portu	portName	string
UNRegionCode	UNRegionCode	string
carrierCityGeoID	carrierCityGeoID	string

Zařízení

Name	Cesta	Typ	Description
locationType	locationType	string
locationName	locationName	string
carrierTerminalCode	carrierTerminalCode	string
carrierTerminalGeoID	carrierTerminalGeoID	string

Service

Name	Cesta	Typ	Description
carrierVoyageNumber	carrierVoyageNumber	string
carrierServiceCode	carrierServiceCode	string
carrierServiceName	carrierServiceName	string

CallSchedule

Name	Cesta	Typ	Description
transportEventTypeCode	transportEventTypeCode	string
eventClassifierCode	eventClassifierCode	string
classifierDateTime	classifierDateTime	date-time

FacilityCall

Name	Cesta	Typ	Description
loď	transport.vessel	Vessel
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortCall

Name	Cesta	Typ	Description
zařízení	facility	Facility
facilityCalls	facilityCalls	array of FacilityCall

VesselCall

Name	Cesta	Typ	Description
zařízení	facility	Facility
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortSchedule

Name	Cesta	Typ	Description
port	port	Port
portCalls	portCalls	array of PortCall

LoďSchedule

Name	Cesta	Typ	Description
loď	vessel	Vessel
vesselCalls	vesselCalls	array of VesselCall

DeliveryDeadline

Seznam konečných termínů pro každý terminál pro zadanou kombinaci plavidla/plavby/přístavu.

Name	Cesta	Typ	Description
terminalName	shipmentDeadlines.terminalName	string	Název terminálu na portu zatížení
termíny	shipmentDeadlines.deadlines	array of object
deadlineName	shipmentDeadlines.deadlines.deadlineName	string	Název konečného termínu
deadlineLocal	shipmentDeadlines.deadlines.deadlineLocal	date-time	Časové razítko konečného termínu v místním čase