---
swagger: "2.0"
info:
title: SERV-SOR-V-PayrollPortabilityInformation
description: The Microservice manages the activities related to Payroll Portability
of customers from and to Banamex Accounts
version: 1.0.0
x-ibm-name: serv-sor-v-payrollportabilityinformation
host: 127.0.0.1
schemes:
- https
basePath: /api
produces:
- application/json
paths:
/v1/servicing/accounts/payroll/portability:
get:
tags:
- retrieve-payroll-portability-info
operationId: retrieve-payroll-portability-info
summary: The API retrieves the details of payroll portability request
description: The API retrieves the details of payroll portability request
consumes:
- application/json
produces:
- application/json
parameters:
- name: client_id
in: header
required: true
type: string
description: Client ID generated during application registration
- name: Authorization
in: header
required: true
type: string
description: The Authorization Token received during login
- name: Accept
in: header
required: true
type: string
description: Content-Types that are acceptable for the response
- name: uuid
in: header
required: true
type: string
description: 128 bit UUID that you generate for every request
- name: Accept-Language
in: header
required: false
type: string
description: List of acceptable human languages for response
- name: Content-Type
in: header
required: true
type: string
description: Content-Types that are sent in the request
- name: ChannelId
in: header
required: true
type: string
description: Channel where request originated
- name: sid
in: header
required: true
type: string
description: SessionId sent by Consumer
- name: countryCode
in: header
required: true
type: string
description: Country code in 2 character ISO 3166 format
- name: businesscode
in: header
required: true
type: string
description: Business code identified during application registration
responses:
200:
description: Successful operation.
schema:
$ref: '#/definitions/RetrievePayrollPortabilityResponse'
400:
description:
Type | Code | Details |
error | invalidRequest | Missing
or invalid Parameters |
schema:
$ref: '#/definitions/ErrorResponse'
401:
description: Type | Code | Details |
error | unAuthorized | Authorization
credentials are missing or invalid |
schema:
$ref: '#/definitions/ErrorResponse'
403:
description: Type | Code | Details | More
Info |
error | accessNotConfigured | The request
operation is not configured to access this resource | Channel/Country/Business
provided in the request is not supported currently |
schema:
$ref: '#/definitions/ErrorResponse'
404:
description: Type | Code | Details | More
Info |
error | resourceNotFound | The requested
resource was not found | Empty resource/resource not found |
schema:
$ref: '#/definitions/ErrorResponse'
422:
description: Type | Code | Details |
error | businessValidationFailed | Business
validation error occured on one or more parameters |
schema:
$ref: '#/definitions/ErrorResponse'
500:
description: Type | Code | Details |
fatal | serverUnavailable | The
request failed due to an internal error/server unavailability |
schema:
$ref: '#/definitions/ErrorResponse'
/v1/servicing/accounts/payroll/portability/manage:
post:
tags:
- create-payroll-portability-info
operationId: create-payroll-portability-info
summary: To create the request of payroll portability for the customer
description: The API is used to create the request of payroll portability for
the customer
consumes:
- application/json
produces:
- application/json
parameters:
- name: client_id
in: header
required: true
type: string
description: Client ID generated during application registration
- name: Authorization
in: header
required: true
type: string
description: The Authorization Token received during login
- name: Accept
in: header
required: true
type: string
description: Content-Types that are acceptable for the response
- name: uuid
in: header
required: true
type: string
description: 128 bit UUID that you generate for every request
- name: Accept-Language
in: header
required: false
type: string
description: List of acceptable human languages for response
- name: Content-Type
in: header
required: true
type: string
description: Content-Types that are sent in the request
- name: ChannelId
in: header
required: true
type: string
description: Channel where request originated
- name: sid
in: header
required: true
type: string
description: SessionId sent by Consumer
- name: countryCode
in: header
required: true
type: string
description: Country code in 2 character ISO 3166 format
- name: businesscode
in: header
required: true
type: string
description: Business code identified during application registration
- name: createPayrollPortabilityRequest
in: body
schema:
$ref: '#/definitions/CreatePayrollPortabilityRequest'
responses:
200:
description: Successful operation.
schema:
$ref: '#/definitions/CreatePayrollPortabilityResponse'
400:
description: Type | Code | Details |
error | invalidRequest | Missing
or invalid Parameters |
schema:
$ref: '#/definitions/ErrorResponse'
401:
description: Type | Code | Details |
error | unAuthorized | Authorization
credentials are missing or invalid |
schema:
$ref: '#/definitions/ErrorResponse'
403:
description: Type | Code | Details | More
Info |
error | accessNotConfigured | The request
operation is not configured to access this resource | Channel/Country/Business
provided in the request is not supported currently |
schema:
$ref: '#/definitions/ErrorResponse'
404:
description: Type | Code | Details | More
Info |
error | resourceNotFound | The requested
resource was not found | Empty resource/resource not found |
schema:
$ref: '#/definitions/ErrorResponse'
422:
description: Type | Code | Details |
error | businessValidationFailed | Business
validation error occured on one or more parameters |
schema:
$ref: '#/definitions/ErrorResponse'
500:
description: Type | Code | Details |
fatal | serverUnavailable | The
request failed due to an internal error/server unavailability |
schema:
$ref: '#/definitions/ErrorResponse'
put:
tags:
- cancel-payroll-portability-info
operationId: cancel-payroll-portability-info
summary: To cancel the request of payroll portability for the customer
description: The API is used to cancel the request of payroll portability for
the customer
consumes:
- application/json
produces:
- application/json
parameters:
- name: client_id
in: header
required: true
type: string
description: Client ID generated during application registration
- name: Authorization
in: header
required: true
type: string
description: The Authorization Token received during login
- name: Accept
in: header
required: true
type: string
description: Content-Types that are acceptable for the response
- name: uuid
in: header
required: true
type: string
description: 128 bit UUID that you generate for every request
- name: Accept-Language
in: header
required: false
type: string
description: List of acceptable human languages for response
- name: Content-Type
in: header
required: true
type: string
description: Content-Types that are sent in the request
- name: ChannelId
in: header
required: true
type: string
description: Channel where request originated
- name: sid
in: header
required: true
type: string
description: SessionId sent by Consumer
- name: countryCode
in: header
required: true
type: string
description: Country code in 2 character ISO 3166 format
- name: businesscode
in: header
required: true
type: string
description: Business code identified during application registration
- name: cancelPayrollPortabilityRequest
in: body
schema:
$ref: '#/definitions/CancelPayrollPortabilityRequest'
responses:
200:
description: Successful operation.
schema:
$ref: '#/definitions/CancelPayrollPortabilityResponse'
400:
description: Type | Code | Details |
error | invalidRequest | Missing
or invalid Parameters |
schema:
$ref: '#/definitions/ErrorResponse'
401:
description: Type | Code | Details |
error | unAuthorized | Authorization
credentials are missing or invalid |
schema:
$ref: '#/definitions/ErrorResponse'
403:
description: Type | Code | Details | More
Info |
error | accessNotConfigured | The request
operation is not configured to access this resource | Channel/Country/Business
provided in the request is not supported currently |
schema:
$ref: '#/definitions/ErrorResponse'
404:
description: Type | Code | Details | More
Info |
error | resourceNotFound | The requested
resource was not found | Empty resource/resource not found |
schema:
$ref: '#/definitions/ErrorResponse'
422:
description: Type | Code | Details |
error | businessValidationFailed | Business
validation error occured on one or more parameters |
schema:
$ref: '#/definitions/ErrorResponse'
500:
description: Type | Code | Details |
fatal | serverUnavailable | The
request failed due to an internal error/server unavailability |
schema:
$ref: '#/definitions/ErrorResponse'
definitions:
RetrievePayrollPortabilityResponse:
type: object
properties:
birthDate:
description: customer's date of birth
type: string
format: date
example: "1989-12-26"
application:
$ref: '#/definitions/PortabilityApplication'
PortabilityApplication:
type: object
properties:
applicationDate:
description: date of application submission
type: string
format: date
example: "2019-12-26"
applicationStatus:
description: portability application status
type: string
example: "1"
cancellationReason:
description: application rejection description
type: string
example: "13"
channelType:
description: Last Requestor Channel
type: string
example: "1"
createdByAgentId:
description: user id of application creator
type: string
example: sb12345
folio:
description: EBPM Folio generated for portability request
type: string
example: "7863289379"
lastApplicationDate:
description: Last application date
type: string
format: date
example: "2019-12-26"
lastApplicationType:
description: last request operation
type: string
example: "1"
lastUpdatedDate:
description: date of last update made to payroll portability
type: string
format: date
example: "2019-12-26"
rejectionReason:
description: reason of portability rejection
type: string
example: "12"
updatedByAgentId:
description: request updated by user
type: string
example: ab12345
destinationAccount:
$ref: '#/definitions/DestinationAccount'
sourceAccount:
$ref: '#/definitions/SourceAccount'
DestinationAccount:
type: object
properties:
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountId:
type: string
description: unique identifier of account mapped to account number
example: "12345678"
accountType:
description: type of account
type: string
example: checking
bankId:
description: bank id
type: string
example: BNX
bankName:
description: Bank Name
type: string
example: Banamex
customerId:
description: unique identifier of the customer
type: string
example: "123456789012"
SourceAccount:
type: object
properties:
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountNumber:
description: account number of the customer
type: string
example: "1234567890"
accountType:
description: type of account
type: string
example: Checking
bankId:
description: unique identifier of bank
type: string
example: BNX
bankName:
description: bank name
type: string
example: Banamex
branchId:
description: branch id of the account
type: string
example: "1234"
CreatePayrollPortabilityRequest:
type: object
properties:
customerId:
description: unique identifier of customer
type: string
example: "123456789012"
portabilityApplication:
$ref: '#/definitions/PortabilityApplicationInfo'
security:
$ref: '#/definitions/Security'
required:
- customerId
PortabilityApplicationInfo:
type: object
properties:
channelType:
description: Requestor Channel
type: string
example: Bancanet
portabilityType:
description: Code to indicate if the portability is to or from banamex account.
Values S for send or R to receive
type: string
example: S
sourceAccountInfo:
$ref: '#/definitions/SourceAccountInfo'
destinationAccountInfo:
$ref: '#/definitions/DestinationAccountInfo'
required:
- portabilityType
SourceAccountInfo:
type: object
properties:
accountId:
type: string
description: unique identifier of account mapped to account number
example: "12345678"
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountNumber:
description: account number of the customer
type: string
example: "1234567890"
cardNumber:
description: Number of the Card.
type: string
example: "566233800020356"
accountType:
description: type of account
type: string
example: Checking
bankId:
description: unique identifier of bank
type: string
example: "12"
bankName:
description: bank name
type: string
example: Banamex
branchId:
description: branch id of the account
type: string
example: "1234"
DestinationAccountInfo:
type: object
properties:
accountId:
type: string
description: unique identifier of account mapped to account number
example: "12345678"
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountNumber:
description: account number of the customer
type: string
example: "1234567890"
accountType:
description: type of account
type: string
example: checking
bankId:
description: bank id
type: string
example: "12"
bankName:
description: Bank Name
type: string
example: Banamex
branchId:
description: branch id of the account
type: string
example: "1234"
cardNumber:
description: card number of the customer
type: string
example: "1234567890123456"
caseId:
description: Unique identifier associated with Case
type: string
example: "232333"
CreatePayrollPortabilityResponse:
type: object
properties:
folio:
description: EBPM Folio generated for portability request
type: string
example: "7863289379"
portabilityTimeStamp:
description: Time stamp when the portability is made it
type: string
format: dateTime
example: 02/07/2020 18:20:40
required:
- portabilityTimeStamp
Security:
type: object
properties:
lastEncryptedChallenge:
type: string
example: 0736H4sIAAAAAAAAAI1STWgTQRR+2SbUNBWq6MFbaEUQIT+SmoSeQtrDyhqDWxXsQSababKyM7POvm2SCp4KQu+eBa967cWbR2+ePAjeBfEgiNSbbzbbNtYeHBjm/b/vfW/efodcpGG5xyQTfFzyKrXq43qlUtr0hS8HrRiHXLrIkP/e/fypFLV/WZC5DfkImUaK4WMNxYh7seaeEmGMlFSKRtwrzaS+PvhhHbb2OhYUbLgs2rHWXOI0AH2PodI2LImuVqg8FTzgOvKVtKEg7nGMtbTltjLa/YhrW1KTyIFFMc1vK9FTCBedJ2yHlQMmB2UXNaFY24KcWGfUH65vOacglg3E8l8ITOiaA/PC7hvxKTwHy4E8qRsUgpPUYPybk5Cn6iVxV/sDX7JgBk7qOy9cHplJ2kMWBIlxHML0fKCbMRchX62kJ9ZnQJ1lcxbqx9zVFwfvX96wAJKqc7TGlTNz1ye0W9/rjpLBfr678nWn/u2ZBfOPiKENb5hwe8eXFOD6u9yBBZEg5nJwNGZiCU/mMDwYi90/Vjt8RAVSNSuOZPof1/5vIrW/t3L45c2yBVkDqIW0xl6MPLJN9Vj0uHYIcIf+adolJ443YSjIwpTQCy7b5g+V7he7AaOGsUBYOCHB0A4IhWqxVm00i/XV5q2QTmTqnEvXY4VGW0zk8B/v3GkvwhKtr7parzUa9eZNIyNkY/qu9MgUcI4gZgTmX+3/AT2pjop1AwAA=
description: 'Challenge previously received (must be same as the given from
get challenge service), composed by "Challenge" : "String State". This is
encrypted by the frontend using Platform
End-to-End encryption APIs.'
encryptedChallengeToken:
type: string
example: 0736H4sIAAAAAAAAAI1STWgTQRR+2SbUNBWq6MFbaEUQIT+SmoSeQtrDyhqDWxXsQSababKyM7POvm2SCp4KQu+eBa967cWbR2+ePAjeBfEgiNSbbzbbNtYeHBjm/b/vfW/efodcpGG5xyQTfFzyKrXq43qlUtr0hS8HrRiHXLrIkP/e/fypFLV/WZC5DfkImUaK4WMNxYh7seaeEmGMlFSKRtwrzaS+PvhhHbb2OhYUbLgs2rHWXOI0AH2PodI2LImuVqg8FTzgOvKVtKEg7nGMtbTltjLa/YhrW1KTyIFFMc1vK9FTCBedJ2yHlQMmB2UXNaFY24KcWGfUH65vOacglg3E8l8ITOiaA/PC7hvxKTwHy4E8qRsUgpPUYPybk5Cn6iVxV/sDX7JgBk7qOy9cHplJ2kMWBIlxHML0fKCbMRchX62kJ9ZnQJ1lcxbqx9zVFwfvX96wAJKqc7TGlTNz1ye0W9/rjpLBfr678nWn/u2ZBfOPiKENb5hwe8eXFOD6u9yBBZEg5nJwNGZiCU/mMDwYi90/Vjt8RAVSNSuOZPof1/5vIrW/t3L45c2yBVkDqIW0xl6MPLJN9Vj0uHYIcIf+adolJ443YSjIwpTQCy7b5g+V7he7AaOGsUBYOCHB0A4IhWqxVm00i/XV5q2QTmTqnEvXY4VGW0zk8B/v3GkvwhKtr7parzUa9eZNIyNkY/qu9MgUcI4gZgTmX+3/AT2pjop1AwAA=
description: Challenge token generated by the hardToken or softToken assigned
to the client, This is encrypted by the frontend using Platform
End-to-End encryption APIs.
CancelPayrollPortabilityRequest:
type: object
properties:
customerId:
description: unique identifier of the customer
type: string
example: "123456789012"
PortabilityApplicationDetail:
$ref: '#/definitions/PortabilityApplicationDetail'
security:
$ref: '#/definitions/SecurityDetail'
required:
- customerId
PortabilityApplicationDetail:
type: object
properties:
cancellationDate:
description: date of application cancellation
type: string
format: date
example: "2019-12-26"
cancellationReason:
description: reason of cancellation
type: string
example: time expired
cancelledByAgentId:
description: user id of application cancellation
type: string
example: sb12345
channelType:
description: Requestor Channel
type: string
example: Bancanet
sourceAccountInfo:
$ref: '#/definitions/SourceAccountDetail'
destinationAccountInfo:
$ref: '#/definitions/DestinationAccountDetail'
SourceAccountDetail:
type: object
properties:
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountNumber:
description: account number of the customer
type: string
example: "1234567890"
accountType:
description: type of account
type: string
example: Checking
bankId:
description: unique identifier of bank
type: string
example: BNX
bankName:
description: bank name
type: string
example: Banamex
branchId:
description: branch id of the account
type: string
example: "1234"
DestinationAccountDetail:
type: object
properties:
accountAlias:
description: CLABE number of the account
type: string
example: "12345678901234"
accountId:
type: string
description: unique identifier of account mapped to account number
example: "12345678"
accountType:
description: type of account
type: string
example: checking
bankId:
description: bank id
type: string
example: BNX
bankName:
description: Bank Name
type: string
example: Banamex
required:
- accountId
SecurityDetail:
type: object
properties:
lastEncryptedChallenge:
type: string
example: 0736H4sIAAAAAAAAAI1STWgTQRR+2SbUNBWq6MFbaEUQIT+SmoSeQtrDyhqDWxXsQSababKyM7POvm2SCp4KQu+eBa967cWbR2+ePAjeBfEgiNSbbzbbNtYeHBjm/b/vfW/efodcpGG5xyQTfFzyKrXq43qlUtr0hS8HrRiHXLrIkP/e/fypFLV/WZC5DfkImUaK4WMNxYh7seaeEmGMlFSKRtwrzaS+PvhhHbb2OhYUbLgs2rHWXOI0AH2PodI2LImuVqg8FTzgOvKVtKEg7nGMtbTltjLa/YhrW1KTyIFFMc1vK9FTCBedJ2yHlQMmB2UXNaFY24KcWGfUH65vOacglg3E8l8ITOiaA/PC7hvxKTwHy4E8qRsUgpPUYPybk5Cn6iVxV/sDX7JgBk7qOy9cHplJ2kMWBIlxHML0fKCbMRchX62kJ9ZnQJ1lcxbqx9zVFwfvX96wAJKqc7TGlTNz1ye0W9/rjpLBfr678nWn/u2ZBfOPiKENb5hwe8eXFOD6u9yBBZEg5nJwNGZiCU/mMDwYi90/Vjt8RAVSNSuOZPof1/5vIrW/t3L45c2yBVkDqIW0xl6MPLJN9Vj0uHYIcIf+adolJ443YSjIwpTQCy7b5g+V7he7AaOGsUBYOCHB0A4IhWqxVm00i/XV5q2QTmTqnEvXY4VGW0zk8B/v3GkvwhKtr7parzUa9eZNIyNkY/qu9MgUcI4gZgTmX+3/AT2pjop1AwAA=
description: 'Challenge previously received (must be same as the given from
get challenge service), composed by "Challenge" : "String State". This is
encrypted by the frontend using Platform
End-to-End encryption APIs.'
encryptedChallengeToken:
type: string
example: 0736H4sIAAAAAAAAAI1STWgTQRR+2SbUNBWq6MFbaEUQIT+SmoSeQtrDyhqDWxXsQSababKyM7POvm2SCp4KQu+eBa967cWbR2+ePAjeBfEgiNSbbzbbNtYeHBjm/b/vfW/efodcpGG5xyQTfFzyKrXq43qlUtr0hS8HrRiHXLrIkP/e/fypFLV/WZC5DfkImUaK4WMNxYh7seaeEmGMlFSKRtwrzaS+PvhhHbb2OhYUbLgs2rHWXOI0AH2PodI2LImuVqg8FTzgOvKVtKEg7nGMtbTltjLa/YhrW1KTyIFFMc1vK9FTCBedJ2yHlQMmB2UXNaFY24KcWGfUH65vOacglg3E8l8ITOiaA/PC7hvxKTwHy4E8qRsUgpPUYPybk5Cn6iVxV/sDX7JgBk7qOy9cHplJ2kMWBIlxHML0fKCbMRchX62kJ9ZnQJ1lcxbqx9zVFwfvX96wAJKqc7TGlTNz1ye0W9/rjpLBfr678nWn/u2ZBfOPiKENb5hwe8eXFOD6u9yBBZEg5nJwNGZiCU/mMDwYi90/Vjt8RAVSNSuOZPof1/5vIrW/t3L45c2yBVkDqIW0xl6MPLJN9Vj0uHYIcIf+adolJ443YSjIwpTQCy7b5g+V7he7AaOGsUBYOCHB0A4IhWqxVm00i/XV5q2QTmTqnEvXY4VGW0zk8B/v3GkvwhKtr7parzUa9eZNIyNkY/qu9MgUcI4gZgTmX+3/AT2pjop1AwAA=
description: Challenge token generated by the hardToken or softToken assigned
to the client, This is encrypted by the frontend using Platform
End-to-End encryption APIs.
CancelPayrollPortabilityResponse:
type: object
properties:
applicationStatus:
description: status of portability application
type: string
example: "1"
folio:
description: EBPM Folio generated for portability request
type: integer
format: int32
example: 2337823
ErrorResponse:
properties:
type:
type: string
description: Invalid - Request did not confirm to the specification and was
unprocessed and rejected. Please fix the value and try again
enum:
- error
- warn
- invalid
- fatal
code:
description: Error code which qualifies the error
type: string
details:
description: Human readable explanation specific to the occurrence of the
problem
type: string
location:
description: The name of the field that resulted in the error
type: string
moreInfo:
description: More Info can be used to pass any additional details
type: string
uuid:
description: 128 bit UUID that you generate for every request
type: string
timestamp:
description: Timestamp of the error
type: string
required:
- type
- code
x-ibm-configuration:
enforced: true
testable: true
phase: realized
securityDefinitions:
OAuth2 Application Flow:
type: oauth2
description: ""
flow: application
scopes:
/api/v1: ""
tokenUrl: https://sandbox.externalapib2b.wlb.nam.nsroot.net:7101/mx-gcgapi-uat/sandbox2/api/v1/oauth/token
Client ID:
type: apiKey
description: ""
in: header
name: X-IBM-Client-Id
security:
- OAuth2 Application Flow:
- /api/v1
Client ID: []
x-ibm-endpoints:
- endpointUrl: https://sandbox.externalapib2b.wlb.nam.nsroot.net:7101/mx-gcgapi-uat/sandbox2
type:
- production
- development
...