Maersk (niezależny wydawca) (wersja zapoznawcza)

Łącznik niestandardowy dla danych wysyłkowych maersk, w tym lokalizacji, statków, harmonogramów i portów. Są to publiczne dane referencyjne.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Premium	Wszystkie regiony usługi Power Automate z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:      — Regiony platformy Azure Government      — Regiony platformy Azure (Chiny)      - Departament Obrony USA (DoD)
Power Apps	Premium	Wszystkie regiony usługi Power Apps z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)
Power Automate	Premium	Wszystkie regiony usługi Power Automate z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)

Kontakt
Name	Dan Romano
Email	dan.romano@swolcat.com

Metadane łącznika
Publisher	Dan Romano
Witryna internetowa	https://developer.maersk.com/api-catalogue
Zasady ochrony prywatności	https://terms.maersk.com/privacy
Kategorie	Dane

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna	Parametry tworzenia połączenia.	Wszystkie regiony	Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Klucz interfejsu API	securestring	Klucz interfejsu API	Prawda

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	100	60 sekund

Akcje

Pobieranie harmonogramów statku według portu	Zwraca zaplanowane wywołania portów dla podanych filtrów.
Pobieranie harmonogramów statków według statku	Zwraca harmonogramy połączeń portowych statku dla danego statku i filtrów podróży.
Pobieranie listy lokalizacji	Zwraca listę lokalizacji obsługiwanych przez narzędzie Maersk.
Pobieranie lokalizacji operatora według identyfikatora geograficznego	Zwraca listę lokalizacji według identyfikatora geograficznego
Uzyskiwanie aktywnych portów	Zwraca listę aktywnych portów obciążenia lub zrzutu wywoływanego przez statki A.P. Moller-Maersk A/S
Uzyskiwanie informacji o statku	Zwraca listę aktywnych statków obsługiwanych przez A.P. Moller-Maersk A/S
Uzyskiwanie terminów wysyłki	Zwraca listę terminów wysyłki na terminal dla danego statku/rejsu/portu ładunku.

Pobieranie harmonogramów statku według portu

Identyfikator operacji:

GetSchedulesByPort

Zwraca zaplanowane wywołania portów dla podanych filtrów.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Kod lokalizacji ONZ	UNLocationCode		string	Kod lokalizacji ORGANIZACJI Narodów Zjednoczonych dla portu (np. USHOU). Wymagane, jeśli nie podano parametru cityName i carrierGeoID.
Nazwa miasta	cityName		string	Nazwa miasta portowego. Wymagane, jeśli nie podano parametru UNLocationCode i carrierGeoID.
Identyfikator geograficzny operatora	carrierGeoID		string	Maersk wewnętrzny identyfikator lokalizacji. Wymagane, jeśli nie podano parametru UNLocationCode i cityName.
Data rozpoczęcia	startDate		date	Data rozpoczęcia harmonogramu portów
Zakres dat	dateRange		string	Zakres od daty rozpoczęcia
Kody przewoźników	carrierCodes	True	string	Wymagane kody operatora

Zwraca

Body

PortSchedule

Pobieranie harmonogramów statków według statku

Identyfikator operacji:

GetSchedulesByVessel

Zwraca harmonogramy połączeń portowych statku dla danego statku i filtrów podróży.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Numer IMO statku	vesselIMONumber		string	7-cyfrowy numer IMO statku
Kod statku przewoźnika	carrierVesselCode		string	3-znakowy kod statku Maersk
Data rozpoczęcia	startDate		date	Data rozpoczęcia harmonogramu
Zakres dat	dateRange		string	Zakres od daty rozpoczęcia
Kody przewoźników	carrierCodes	True	string	Kody przewoźnika wymagane przez narzędzie Maersk

Zwraca

Body

VesselSchedule

Pobieranie listy lokalizacji

Identyfikator operacji:

GetLocations

Zwraca listę lokalizacji obsługiwanych przez narzędzie Maersk.

Zwraca

response

array of Location

Pobieranie lokalizacji operatora według identyfikatora geograficznego

Identyfikator operacji:

GetCarrierLocationByGeoID

Zwraca listę lokalizacji według identyfikatora geograficznego

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator geograficzny operatora	carrierGeoID	True	string	Identyfikator geograficzny operatora Maersk

Zwraca

Body

CarrierLocation

Uzyskiwanie aktywnych portów

Identyfikator operacji:

GetActivePorts

Zwraca listę aktywnych portów obciążenia lub zrzutu wywoływanego przez statki A.P. Moller-Maersk A/S

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Kody przewoźników	carrierCodes	True	string	Co najmniej jeden kod przewoźnika (np. MAEU). Rozdzielane przecinkami, jeśli wiele.
Kody kraju	countryCodes		string	Opcjonalne kody krajów ISO 3166-1 alfa-2 (np. USA, CN)

Zwraca

response

array of Port

Uzyskiwanie informacji o statku

Identyfikator operacji:

GetVessels

Zwraca listę aktywnych statków obsługiwanych przez A.P. Moller-Maersk A/S

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Numery statków IMO	vesselIMONumbers		string	Rozdzielane przecinkami liczby IMO (np. "9332999,9458030")
Kody statków przewoźników	carrierVesselCodes		string	Rozdzielona przecinkami lista wartości (np. "9332999,9458030")

Zwraca

response

array of Vessel

Uzyskiwanie terminów wysyłki

Identyfikator operacji:

GetDeadlines

Zwraca listę terminów wysyłki na terminal dla danego statku/rejsu/portu ładunku.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Kod kraju ISO	ISOCountryCode	True	string	Kod kraju ISO portu (np. STANY ZJEDNOCZONE)
Port ładowania	portOfLoad	True	string	Nazwa miasta lub portu (np. Houston)
Numer IMO statku	vesselIMONumber	True	string	Numer IMO statku
Podróż	voyage	True	string	Numer podróży (np. 010E)

Zwraca

response

array of ShipmentDeadline

Definicje

Lokalizacja

Nazwa	Ścieżka	Typ	Opis
Kod kraju	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName (nazwa_lokalizacji)	locationName	string
carrierGeoID	carrierGeoID	string
UNRegionCode	UNRegionCode	string
UNRegionName	UNRegionName	string

CarrierLocation

Nazwa	Ścieżka	Typ	Opis
Kod kraju	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName (nazwa_lokalizacji)	locationName	string
carrierGeoID	carrierGeoID	string
carrierRkstCode	carrierRkstCode	string
carrierRktsCode	carrierRktsCode	string
timeZoneID	timeZoneID	string
carrierCountryGeoID	carrierCountryGeoID	string
UNLocationCode	UNLocationCode	string
UNRegionCode	UNRegionCode	string
UNRegionName	UNRegionName	string

Naczynie

Nazwa	Ścieżka	Typ	Opis
vesselIMONumber	vesselIMONumber	string
carrierVesselCode	carrierVesselCode	string
vesselName	vesselName	string
vesselFlagCode	vesselFlagCode	string
vesselCallSign	vesselCallSign	string

Port

Nazwa	Ścieżka	Typ	Opis
Kod kraju	countryCode	string
countryName	countryName	string
UNLocationCode	UNLocationCode	string
cityName	cityName	string
nazwa_portu	portName	string
UNRegionCode	UNRegionCode	string
carrierCityGeoID	carrierCityGeoID	string

Pomieszczenie

Nazwa	Ścieżka	Typ	Opis
locationType	locationType	string
locationName (nazwa_lokalizacji)	locationName	string
carrierTerminalCode	carrierTerminalCode	string
carrierTerminalGeoID	carrierTerminalGeoID	string

Usługa

Nazwa	Ścieżka	Typ	Opis
carrierVoyageNumber	carrierVoyageNumber	string
carrierServiceCode	carrierServiceCode	string
carrierServiceName	carrierServiceName	string

CallSchedule

Nazwa	Ścieżka	Typ	Opis
transportEventTypeCode	transportEventTypeCode	string
eventClassifierCode	eventClassifierCode	string
classifierDateTime	classifierDateTime	date-time

FacilityCall

Nazwa	Ścieżka	Typ	Opis
naczynie	transport.vessel	Vessel
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortCall

Nazwa	Ścieżka	Typ	Opis
Obiektu	facility	Facility
facilityCalls	facilityCalls	array of FacilityCall

VesselCall

Nazwa	Ścieżka	Typ	Opis
Obiektu	facility	Facility
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortSchedule

Nazwa	Ścieżka	Typ	Opis
port	port	Port
portCalls	portCalls	array of PortCall

StatekSchedule

Nazwa	Ścieżka	Typ	Opis
naczynie	vessel	Vessel
vesselCalls	vesselCalls	array of VesselCall

WysyłkaDeadline

Lista terminów ostatecznych dla każdego terminalu dla określonej kombinacji statku/rejsu/portu.

Nazwa	Ścieżka	Typ	Opis
terminalName	shipmentDeadlines.terminalName	string	Nazwa terminalu na porcie ładowania
Terminy	shipmentDeadlines.deadlines	array of object
deadlineName	shipmentDeadlines.deadlines.deadlineName	string	Nazwa terminu ostatecznego
deadlineLocal	shipmentDeadlines.deadlines.deadlineLocal	date-time	Sygnatura czasowa terminu ostatecznego w czasie lokalnym