Maersk (Editor Independente) (versão prévia)

Conector personalizado para dados de envio da Maersk, incluindo locais, embarcações, agendas e portas. São dados de referência pública.

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Dan Romano
Email	dan.romano@swolcat.com

Metadados do conector
Publicador	Dan Romano
Site	https://developer.maersk.com/api-catalogue
Política de privacidade	https://terms.maersk.com/privacy
Categorias	Dados

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:


Default	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Chave de API	secureString	A chave de API	Verdade

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	100	60 segundos

Ações

Obter a localização da transportadora por ID geográfica	Retorna uma lista de locais por ID geográfica
Obter agendamentos de navios por navio	Retorna agendamentos de chamadas portuárias de navios para os filtros de embarcação e viagem determinados.
Obter agendamentos de navios por porta	Retorna chamadas de porta agendadas para os filtros fornecidos.
Obter informações sobre o navio	Retorna uma lista de navios ativos operados pela A.P. Moller-Maersk A/S
Obter lista de locais	Retorna uma lista de locais com suporte da Maersk.
Obter portas ativas	Retorna uma lista de portas ativas de Carregamento ou Descarga chamadas por navios A.P. Moller-Maersk A/S
Obter prazos de remessa	Retorna uma lista de prazos de remessa por terminal para um determinado navio/viagem/porta de carga.

Obter a localização da transportadora por ID geográfica

ID da operação:: GetCarrierLocationByGeoID

Retorna uma lista de locais por ID geográfica

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID geográfica da transportadora	carrierGeoID	True	string	ID geográfica da transportadora Maersk

Retornos

Corpo: CarrierLocation

Obter agendamentos de navios por navio

ID da operação:: GetSchedulesByVessel

Retorna agendamentos de chamadas portuárias de navios para os filtros de embarcação e viagem determinados.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Número de IMO do navio	vesselIMONumber		string	Número de IMO de 7 dígitos para o navio
Código do navio porta-aviões	carrierVesselCode		string	Código do navio Maersk de 3 caracteres
Data de Início	startDate		date	Data de início da agenda
Intervalo de datas	dateRange		string	Intervalo da data de início
Códigos da transportadora	carrierCodes	True	string	Códigos de transportadora, exigidos pela Maersk

Retornos

Corpo: VesselSchedule

Obter agendamentos de navios por porta

ID da operação:: GetSchedulesByPort

Retorna chamadas de porta agendadas para os filtros fornecidos.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Código de localização da ONU	UNLocationCode		string	Código de localização das Nações Unidas para o porto (por exemplo, USHOU). Obrigatório se cityName e carrierGeoID não forem fornecidos.
Nome da Cidade	cityName		string	Nome da cidade portuária. Necessário se UNLocationCode e carrierGeoID não forem fornecidos.
ID geográfica da transportadora	carrierGeoID		string	Identificador de localização interna do Maersk. Obrigatório se UNLocationCode e cityName não forem fornecidos.
Data de Início	startDate		date	Data de início do agendamento da porta
Intervalo de datas	dateRange		string	Intervalo da data de início
Códigos da transportadora	carrierCodes	True	string	Códigos de transportadora necessários

Retornos

Corpo: PortSchedule

Obter informações sobre o navio

ID da operação:: GetVessels

Retorna uma lista de navios ativos operados pela A.P. Moller-Maersk A/S

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Números de embarcações de IMO	vesselIMONumbers		string	Números de IMO separados por vírgulas (por exemplo, "9332999,9458030")
Códigos da embarcação transportadora	carrierVesselCodes		string	Lista de valores separada por vírgulas (por exemplo, "9332999,9458030")

Retornos

response: array of Vessel

Obter lista de locais

ID da operação:: GetLocations

Retorna uma lista de locais com suporte da Maersk.

Retornos

response: array of Location

Obter portas ativas

ID da operação:: GetActivePorts

Retorna uma lista de portas ativas de Carregamento ou Descarga chamadas por navios A.P. Moller-Maersk A/S

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Códigos da transportadora	carrierCodes	True	string	Um ou mais códigos de transportadora (por exemplo, MAEU). Separado por vírgula se múltiplo.
Códigos de país	countryCodes		string	Códigos de país opcionais ISO 3166-1 alfa-2 (por exemplo, EUA, CN)

Retornos

response: array of Port

Obter prazos de remessa

ID da operação:: GetDeadlines

Retorna uma lista de prazos de remessa por terminal para um determinado navio/viagem/porta de carga.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Código do país ISO	ISOCountryCode	True	string	Código do país ISO da porta (por exemplo, EUA)
Porta de carga	portOfLoad	True	string	Nome da cidade ou porta (por exemplo, Houston)
Número de IMO do navio	vesselIMONumber	True	string	Número de IMO do navio
Viagem	voyage	True	string	Número da viagem (por exemplo, 010E)

Retornos

response: array of ShipmentDeadline

Definições

Localização

Nome	Caminho	Tipo
código do país	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName	locationName	string
carrierGeoID	carrierGeoID	string
UNRegionCode	UNRegionCode	string
UNRegionName	UNRegionName	string

CarrierLocation

Nome	Caminho	Tipo
código do país	countryCode	string
countryName	countryName	string
cityName	cityName	string
locationType	locationType	string
locationName	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

Navio

Nome	Caminho	Tipo
vesselIMONumber	vesselIMONumber	string
carrierVesselCode	carrierVesselCode	string
vesselName	vesselName	string
vesselFlagCode	vesselFlagCode	string
vesselCallSign	vesselCallSign	string

Porto

Nome	Caminho	Tipo
código do país	countryCode	string
countryName	countryName	string
UNLocationCode	UNLocationCode	string
cityName	cityName	string
portName	portName	string
UNRegionCode	UNRegionCode	string
carrierCityGeoID	carrierCityGeoID	string

Recurso

Nome	Caminho	Tipo
locationType	locationType	string
locationName	locationName	string
carrierTerminalCode	carrierTerminalCode	string
carrierTerminalGeoID	carrierTerminalGeoID	string

Service

Nome	Caminho	Tipo
carrierVoyageNumber	carrierVoyageNumber	string
carrierServiceCode	carrierServiceCode	string
carrierServiceName	carrierServiceName	string

CallSchedule

Nome	Caminho	Tipo
transportEventTypeCode	transportEventTypeCode	string
eventClassifierCode	eventClassifierCode	string
classifierDateTime	classifierDateTime	date-time

FacilityCall

Nome	Caminho	Tipo
navio	transport.vessel	Vessel
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortCall

Nome	Caminho	Tipo	Description
instalação	facility	Facility
facilityCalls	facilityCalls	array of FacilityCall

VesselCall

Nome	Caminho	Tipo
instalação	facility	Facility
inboundService	transport.inboundService	Service
outboundService	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

PortSchedule

Nome	Caminho	Tipo	Description
porta	port	Port
portCalls	portCalls	array of PortCall

VesselSchedule

Nome	Caminho	Tipo	Description
navio	vessel	Vessel
vesselCalls	vesselCalls	array of VesselCall

ShipmentDeadline

A lista de prazos para cada terminal para a combinação especificada de navio/viagem/porta.

Nome	Caminho	Tipo	Description
terminalName	shipmentDeadlines.terminalName	string	Nome do terminal na porta de carregamento
Prazos	shipmentDeadlines.deadlines	array of object
deadlineName	shipmentDeadlines.deadlines.deadlineName	string	O nome do prazo
deadlineLocal	shipmentDeadlines.deadlines.deadlineLocal	date-time	O carimbo de data/hora do prazo no horário local

Compartilhar via

Maersk (Editor Independente) (versão prévia)

Criando uma conexão

Padrão

Limitações

Ações

Obter a localização da transportadora por ID geográfica

Parâmetros

Retornos

Obter agendamentos de navios por navio

Parâmetros

Retornos

Obter agendamentos de navios por porta

Parâmetros

Retornos

Obter informações sobre o navio

Parâmetros

Retornos

Obter lista de locais

Retornos

Obter portas ativas

Parâmetros

Retornos

Obter prazos de remessa

Parâmetros

Retornos

Definições

Localização

CarrierLocation

Navio

Porto

Recurso

Service

CallSchedule

FacilityCall

PortCall

VesselCall

PortSchedule

VesselSchedule

ShipmentDeadline