Compartilhar via

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 Description
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 Description
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
Nome Caminho Tipo Description
vesselIMONumber
 vesselIMONumber string
carrierVesselCode
 carrierVesselCode string
vesselName
 vesselName string
vesselFlagCode
 vesselFlagCode string
vesselCallSign
 vesselCallSign string

Porto

Nome Caminho Tipo Description
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 Description
locationType
 locationType string
locationName
 locationName string
carrierTerminalCode
 carrierTerminalCode string
carrierTerminalGeoID
 carrierTerminalGeoID string

Service

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

CallSchedule

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

FacilityCall

Nome Caminho Tipo Description
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 Description
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