Maersk (publicador independiente) (versión preliminar)
Conector personalizado para los datos de envío de Maersk, incluidas ubicaciones, buques, programaciones y puertos. Se trata de datos de referencia públicos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Dan Romano |
| Correo Electrónico | dan.romano@swolcat.com |
| Metadatos del conector | |
|---|---|
| Publicador | Dan Romano |
| Website | https://developer.maersk.com/api-catalogue |
| Directiva de privacidad | https://terms.maersk.com/privacy |
| Categorías | Data |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Obtención de información del buque |
Devuelve una lista de buques activos operados por A.P. Moller-Maersk A/S |
| Obtención de la ubicación del operador por identificador geográfico |
Devuelve una lista de ubicaciones por identificador geográfico |
| Obtención de programaciones de buques por buque |
Devuelve los horarios de las llamadas de puerto de buque para el buque y los filtros de viaje especificados. |
| Obtención de programaciones de buques por puerto |
Devuelve llamadas de puerto programadas para los filtros proporcionados. |
| Obtención de puertos activos |
Devuelve una lista de puertos activos de carga o descarga a los que llama A.P. Moller-Maersk buques A/S. |
| Obtener fechas límite de envío |
Devuelve una lista de fechas límite de envío por terminal para un buque o viaje o puerto de carga determinado. |
| Obtener la lista de ubicaciones |
Devuelve una lista de ubicaciones compatibles con Maersk. |
Obtención de información del buque
Devuelve una lista de buques activos operados por A.P. Moller-Maersk A/S
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Números de buque de la OMI
|
vesselIMONumbers | string |
Números IMO separados por comas (por ejemplo, "9332999,9458030") |
|
|
Códigos de buque de transporte
|
carrierVesselCodes | string |
Lista separada por comas de valores (por ejemplo, "9332999,9458030") |
Devoluciones
- response
- array of Vessel
Obtención de la ubicación del operador por identificador geográfico
Devuelve una lista de ubicaciones por identificador geográfico
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. geográfico del operador
|
carrierGeoID | True | string |
Id. geográfico del operador maersk |
Devoluciones
- Body
- CarrierLocation
Obtención de programaciones de buques por buque
Devuelve los horarios de las llamadas de puerto de buque para el buque y los filtros de viaje especificados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de IMO del buque
|
vesselIMONumber | string |
Número IMO de 7 dígitos para el buque |
|
|
Código de buque portador
|
carrierVesselCode | string |
Código de recipiente de Maersk de 3 caracteres |
|
|
Fecha de inicio
|
startDate | date |
Fecha de inicio de la programación |
|
|
Intervalo de fechas
|
dateRange | string |
Intervalo desde la fecha de inicio |
|
|
Códigos de operador
|
carrierCodes | True | string |
Códigos de operador, requeridos por Maersk |
Devoluciones
- Body
- VesselSchedule
Obtención de programaciones de buques por puerto
Devuelve llamadas de puerto programadas para los filtros proporcionados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Código de ubicación UN
|
UNLocationCode | string |
Código de ubicación de las Naciones Unidas para el puerto (por ejemplo, USHOU). Obligatorio si no se proporciona cityName y carrierGeoID. |
|
|
Nombre de la ciudad
|
cityName | string |
Nombre de la ciudad del puerto. Obligatorio si no se proporcionan UNLocationCode y carrierGeoID. |
|
|
Id. geográfico del operador
|
carrierGeoID | string |
Identificador de ubicación interna de Maersk. Obligatorio si no se proporcionan UNLocationCode y cityName. |
|
|
Fecha de inicio
|
startDate | date |
Fecha de inicio de la programación del puerto |
|
|
Intervalo de fechas
|
dateRange | string |
Intervalo desde la fecha de inicio |
|
|
Códigos de operador
|
carrierCodes | True | string |
Códigos de operador obligatorios |
Devoluciones
- Body
- PortSchedule
Obtención de puertos activos
Devuelve una lista de puertos activos de carga o descarga a los que llama A.P. Moller-Maersk buques A/S.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Códigos de operador
|
carrierCodes | True | string |
Uno o más códigos de transporte (por ejemplo, MAEU). Separados por comas si hay varios. |
|
Códigos de país
|
countryCodes | string |
Códigos de país iso 3166-1 alfa-2 opcionales (por ejemplo, EE. UU., CN) |
Devoluciones
- response
- array of Port
Obtener fechas límite de envío
Devuelve una lista de fechas límite de envío por terminal para un buque o viaje o puerto de carga determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Código de país ISO
|
ISOCountryCode | True | string |
Código de país ISO del puerto (por ejemplo, EE. UU.) |
|
Puerto de carga
|
portOfLoad | True | string |
Nombre de ciudad o puerto (por ejemplo, Houston) |
|
Número de IMO del buque
|
vesselIMONumber | True | string |
Número IMO del buque |
|
Viaje
|
voyage | True | string |
Número de viaje (por ejemplo, 010E) |
Devoluciones
- response
- array of ShipmentDeadline
Obtener la lista de ubicaciones
Definiciones
Ubicación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
countryCode
|
countryCode | string | |
|
countryName
|
countryName | string | |
|
cityName
|
cityName | string | |
|
locationType
|
locationType | string | |
|
locationName
|
locationName | string | |
|
carrierGeoID
|
carrierGeoID | string | |
|
UNRegionCode
|
UNRegionCode | string | |
|
UNRegionName
|
UNRegionName | string |
CarrierLocation
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
countryCode
|
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 |
Vaso
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
vesselIMONumber
|
vesselIMONumber | string | |
|
carrierVesselCode
|
carrierVesselCode | string | |
|
vesselName
|
vesselName | string | |
|
vesselFlagCode
|
vesselFlagCode | string | |
|
vesselCallSign
|
vesselCallSign | string |
Puerto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
countryCode
|
countryCode | string | |
|
countryName
|
countryName | string | |
|
UNLocationCode
|
UNLocationCode | string | |
|
cityName
|
cityName | string | |
|
nombre del puerto
|
portName | string | |
|
UNRegionCode
|
UNRegionCode | string | |
|
carrierCityGeoID
|
carrierCityGeoID | string |
Instalación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
locationType
|
locationType | string | |
|
locationName
|
locationName | string | |
|
carrierTerminalCode
|
carrierTerminalCode | string | |
|
carrierTerminalGeoID
|
carrierTerminalGeoID | string |
Service
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
carrierVoyageNumber
|
carrierVoyageNumber | string | |
|
carrierServiceCode
|
carrierServiceCode | string | |
|
carrierServiceName
|
carrierServiceName | string |
CallSchedule
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
transportEventTypeCode
|
transportEventTypeCode | string | |
|
eventClassifierCode
|
eventClassifierCode | string | |
|
classifierDateTime
|
classifierDateTime | date-time |
FacilityCall
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
vaso
|
transport.vessel | Vessel | |
|
inboundService
|
transport.inboundService | Service | |
|
outboundService
|
transport.outboundService | Service | |
|
callSchedules
|
callSchedules | array of CallSchedule |
PortCall
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
facilidad
|
facility | Facility | |
|
facilityCalls
|
facilityCalls | array of FacilityCall |
VesselCall
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
facilidad
|
facility | Facility | |
|
inboundService
|
transport.inboundService | Service | |
|
outboundService
|
transport.outboundService | Service | |
|
callSchedules
|
callSchedules | array of CallSchedule |
PortSchedule
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
port
|
port | Port | |
|
portCalls
|
portCalls | array of PortCall |
VesselSchedule
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
vaso
|
vessel | Vessel | |
|
vesselCalls
|
vesselCalls | array of VesselCall |
ShipmentDeadline
Lista de fechas límite para cada terminal para la combinación de buques, viajes y puertos especificados.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
terminalName
|
shipmentDeadlines.terminalName | string |
Nombre del terminal en el puerto de carga |
|
Plazos
|
shipmentDeadlines.deadlines | array of object | |
|
deadlineName
|
shipmentDeadlines.deadlines.deadlineName | string |
Nombre de la fecha límite |
|
deadlineLocal
|
shipmentDeadlines.deadlines.deadlineLocal | date-time |
Marca de tiempo de la fecha límite en la hora local |