API - Documentación

API Endpoint

http://meli.d1c.pcnt.io

Introduction ¶

Autenticación

La forma de autenticación es mediante un login utilizando un access_key y secret que será provisto, al invocar al endpoint de /login/api esto nos retornará un token (JWT).

Dicho JWT mientras esté en uso nunca expira, ademas soportamos tener varios JWT generados en simultáneo bajo el mismo access_key y secret, esto es útil cuando se utiliza la api desde varios microservicios en simultáneo.

Cuando el JWT expira por inactividad las apis retornan un HTTP 401.

Headers

organization: Siglas de la organización que está invocando el servicio, debe enviarse con la key que se le enviará junto con el access_key y secret

account: Número de cuenta comitente que está invocando el servicio. Este header solo es requerido para aquellas apis que involucren operaciones sobre cuentas.

Authorization: se envia el token que se obtuvo en el endpoint login, antes del token hay que concatenar la palabra JWT
Ejemplo: Authorization: JWT FDASFFAFDSF#$23423DSADSDAS=

ThirdPartyId

Es un Id generado por el consumidor de la API, este Id debe ser único ya que se le aplica el concepto de idempotencia.

Idempotencia En todas nuestras Apis transaccionales implementamos este concepto matemático, esto quiere decir que bajo un mismo thirdPartyId siempre vamos a retornar la misma respusta en otras palabras, cada thirdPartyId debe corresponder a una única operación.
https://es.wikipedia.org/wiki/Idempotencia

Organization

Son siglas que determinan inequivocamente a una determinada organización. En todos los lugares de la documentación donde se vea <organization> se debe reemplazar por las siglas brindadas que determinan su organización.

Ejemplo Si la organización brindada es MELI, cambiar <organization> por MELI.

Auth ¶

POST http://meli.d1c.pcnt.io/profile/v1/login/api

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>

Body

{
    "username": "access_key_generado",
    "password": "secret_generado",
}

Responses200401409

Headers

Content-Type: application/json

Body

{
  "token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A"
}

Headers

Content-Type: application/json

Body

{
    "code": "INVALID_LOGIN",
    "process": "948595173290356736",
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Autenticarse en pcnt d1c
POST`/profile/v1/login/api`

Mediante este servicio se autentica con access_key / secret, y se obtiene un JWT que deberá ser usado en los posteriores requests.

Header

Campo	Tipo	Descripción
organization	String	Siglas de la organización que está invocando el servicio

Request

Campo	Tipo	Descripción
username	String (required)	Es el 'access_key' proporcionado
password	String (required)	Es el 'secret' proporcionado

Response

Campo	Tipo	Descripción
token	String	JWT token de autenticación
expires_in_seconds	Number	Tiempo de expiración

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.

Error de authenticacion por credenciales devolveran código HTTP 401. En el anexo de errores se detalla el formato de los mismos.

Cuenta ¶

Creación de cuenta ¶

POST http://meli.d1c.pcnt.io/profile/v1/account

RequestsCreación de cuenta con imágenes via linkCreación de cuenta con imágenes en base64

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "XU231A",
  "person": {
    "naturalPerson": true,
    "name": "Romina Paola",
    "lastname": "Pizzo",
    "nationality": "AR",
    "residenceCountry": "AR",
    "identificationType": "DNI",
    "identification": "28334194",
    "identificationCountry": "AR",
    "maritalState": "SINGLE",
    "birthDate": "1978-03-04",
    "birthPlace": "AR",
    "gender": "F",
    "taxInformation": {
      "type": "CUIT",
      "number": "27283341947",
      "businessActivity": "11341",
      "pep": {
        "isPep": true,
        "description": "Diputado Nacional"
      },
      "incomeInscription": {
        "type": "EXE",
        "date": "1998-10-04"
      },
      "ivaCondition": "RI",
      "countryTaxResidence": "AR",
      "fatca": {
        "isFatca": true,
        "ssn": "1491949991"
      },
      "ocde": {
        "isOcde": true,
        "countryTaxResidencePrincipal": "UY",
        "nitPrincipal": "12355550",
        "countryTaxResidenceOptional": "BR",
        "nitOptional": "12355554"
      },
      "subjectsBound": {
        "isSubjectsBound": true,
        "createdDate": "1998-10-04"
      }
    }
  },
  "address": {
    "type": "LEGAL",
    "street": "Helguera",
    "number": "2177",
    "floor": "3",
    "apartment": "A",
    "block": "1",
    "sector": "A",
    "tower": "1",
    "zipCode": "1752",
    "country": "AR",
    "state": "AR",
    "locality": "CABA"
  },
  "contact": {
    "email": "ejemplo@mail.com",
    "phone": "12341234",
    "areaCode": "011"
  },
  "documents": [
    {
      "type": "FRONT_DNI",
      "description": "Frente DNI",
      "filename": "frente.png",
      "extension": ".png",
      "verified": true,
      "file": {
        "url": "http://contentcdn.com/imagenes/12345.png"
      }
    }
  ],
  "identityVerification": {
    "id": "21223213213"
  },
  "banks": {
    "identification": "0000347730000000049606",
    "type": "CVU"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "account": "234234"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "XU231A",
  "person": {
    "naturalPerson": true,
    "name": "Romina Paola",
    "lastname": "Pizzo",
    "nationality": "AR",
    "residenceCountry": "AR",
    "identificationType": "DNI",
    "identification": "28334194",
    "identificationCountry": "AR",
    "maritalState": "SINGLE",
    "birthDate": "1978-03-04",
    "birthPlace": "AR",
    "gender": "F",
    "taxInformation": {
      "type": "CUIT",
      "number": "27283341947",
      "businessActivity": "11341",
      "pep": {
        "isPep": true,
        "description": "Diputado Nacional"
      },
      "incomeInscription": {
        "type": "EXE",
        "date": "1998-10-04"
      },
      "ivaCondition": "RI",
      "countryTaxResidence": "AR",
      "fatca": {
        "isFatca": true,
        "ssn": "1491949991"
      },
      "ocde": {
        "isOcde": true,
        "countryTaxResidencePrincipal": "UY",
        "nitPrincipal": "12355550",
        "countryTaxResidenceOptional": "BR",
        "nitOptional": "12355554"
      },
      "subjectsBound": {
        "isSubjectsBound": true,
        "createdDate": "1998-10-04"
      }
    }
  },
  "address": {
    "type": "LEGAL",
    "street": "Helguera",
    "number": "2177",
    "floor": "3",
    "apartment": "A",
    "block": "1",
    "sector": "A",
    "tower": "1",
    "zipCode": "1752",
    "country": "AR",
    "state": "AR",
    "locality": "CABA"
  },
  "contact": {
    "email": "ejemplo@mail.com",
    "phone": "12341234",
    "areaCode": "011"
  },
  "documents": [
    {
      "type": "FRONT_DNI",
      "description": "Frente DNI",
      "filename": "frente.png",
      "extension": ".png",
      "verified": true,
      "file": {
        "base64": "WEREWREWREWREWREREWRWE...."
      }
    }
  ],
  "identityVerification": {
    "id": "21223213213"
  },
  "banks": {
    "identification": "0000347730000000049606",
    "type": "CVU"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "account": "234234"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Creación de cuenta
POST`/profile/v1/account`

Servicio para la creación de una nueva cuenta.

Header Request

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio

Request

Campo	Tipo	Descripción
thirdPartyId	String (require)	Id externo
person	Object [Person]	Datos de la persona ver Person
address	Object [Address]	Dirección ver Address
contact	Object [Contact]	Contacto ver Contact
documents	Object [Document]	Documento ver Document
identityVerification	Object [IdentityVerification]	IdentityVerification ver IdentityVerification
banks	Object [Bank]	Bank ver Bank

Person - Object
Campo	Tipo	Descripción
naturalPerson	Boolean (require)	Indica si es una persona natural teniendo como posibles valores true o false
name	String (require)	Nombre
lastname	String (require)	Apellido
nationality	String (require)	Nacionalidad - código ISO país dos letras - Ver anexo
residenceCountry	String (require)	País de residencia - código ISO país dos letras - Ver anexo
identificationType	String (require)	Tipo de documento de identidad. Posibles valores: DNI
identification	String (require)	Número de documento de identidad
identificationCountry	String (require)	País emisor del documento de identidad - código ISO país dos letras - Ver anexo
maritalState	String (require)	Estado civil. Posibles valores: SINGLE WIDOWED MARRIED DIVORCED CONCUBINAGE OTHER
birthDate	String (require)	Fecha de nacimiento
birthPlace	String (require)	País de nacimiento - código ISO país dos letras - Ver anexo
gender	String (require)	Género. Posibles valores M F
taxInformation	Object [TaxInformation]	Información fiscal ver TaxInformation

TaxInformation - Object
Campo	Tipo	Descripción
type	String (require)	Tipo de documento de identidad. Posibles valores: DNI LE LC CUIT CUIL CDI
number	String (require)	Número de documento de identidad
businessActivity	String	Código AFIP de actividad comercial ver Listado de códigos afip
pep	Object [Pep]	Información de Persona Expuesta Políticamente ver Pep
incomeInscription	Object [IncomeInscription]	Condición frente a ganancias ver IncomeInscription
ivaCondition	String (require)	Condición frente al IVA ver Códigos
countryTaxResidence	String	País de residencia fiscal - código ISO país dos letras - Ver anexo
fatca	Object [Facta]	FATCA ver Facta
ocde	Object [Ocde]	OCDE ver Ocde
subjectsBound	Object [SubjectsBound]	Sujeto Obligado ver SubjectsBound

Pep - Object
Campo	Tipo	Descripción
isPep	Boolean (require)	Indica si la persona es una Persona Expuesta Políticamente
description	String (require)	Descripción de Persona Expuesta Políticamente

IncomeInscription - Object
Campo	Tipo	Descripción
type	String (require)	Tipo de condición frente a ganancias ver Códigos
date	String (require)	Fecha desde que es contribuyente de ganancias

Fatca - Object
Campo	Tipo	Descripción
isFatca	Boolean (require)	Indica si la persona es alcanzada por FATCA
ssn	String (require)	Número FATCA

Ocde - Object
Campo	Tipo	Descripción
isOcde	Boolean (require)	Indica si la persona es alcanzada por OCDE
countryTaxResidencePrincipal	String	País de residencia fiscal principal \| Enviar codigo ISO país 2 letras (Ver anexo de código de países)
nitPrincipal	String	Nit del pais de residencia principal
countryTaxResidenceOptional	String	País de residencia fiscal opcional \| Enviar codigo ISO país 2 letras (Ver anexo de código de países)
nitOptional	String	Nit del pais de residencia opcional

SubjectsBound - Object
Campo	Tipo	Descripción
isSubjectsBound	Boolean (require)	Indica si la persona es sujeto obligado
type	String	Tipo de Sujeto Obligado
createdDate	String	Fecha desde la que es Sujeto Obligado

Contact - Object
Campo	Tipo	Descripción
areaCode	String	Código de área del teléfono del miembro principal
email	String	Email del miembro principal
phone	String	Teléfono del miembro principal

Document - Object
Campo	Tipo	Descripción
type	String	FRONT_DNI BACK_DNI SELFIE INCOME_PROOF SERVICE SIGNATURE
description	String (required)	Descripción del documento
filename	String (required)	Nombre del archivo
extension	String (required)	Extensión del archivo
verified	Boolean (required)	Indica si el documento está verificado
file	File (required)	Archivo asociado al documento ver File

File - Object
Campo	Tipo	Descripción
url	String	URL del archivo
base64	String	String Base64 del archivo

IdentityVerification - Object
Campo	Tipo	Descripción
id	String	Id de biometria

Bank - Object
Campo	Tipo	Descripción
type	String	Tipo de identificación bancaria. Posibles valores: CBU CVU
identification	String	Identificación bancaria

Address - Object
Campo	Tipo	Descripción
type	String	Tipo de domicilio. Posibles valores: LEGAL HOME WORK
street	String	Calle
number	String	Calle
floor	String	Piso
apartment	String	Departamento
block	String	Bloque
sector	String	sector
tower	String	Torre
zipCode	String	Código postal
country	String	País - código ISO país dos letras - Ver anexo
state	String	Provincia/Estado - código de provincia dos letras - Ver anexo
locality	String	Localidad

Response

Campo	Tipo	Descripción
account	String	Número de cuenta comitente
status	String	Estado de la cuenta Ver anexo

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
REQUIRED_FIELD_WITH_NULL_VALUE	Campo requerido.
THIRD_PARTY_ID_ALREADY_USE_FOR_ANOTHER_TAX_IDENTIFICATION	Thirdparty utilizado para otro CUIT.
INVALID_TAX_INFORMATION_NUMBER	CUIT invalido o con problemas en la AFIP.
HIT_ON_BLACK_LIST_15	Hit contra lista negra numero 15.
HIT_ON_BLACK_LIST_37	Hit contra lista negra numero 37.
HIT_ON_BLACK_LIST_41	Hit contra lista negra numero 41.
INVALID_NAME	Nombre de la persona invalido.
INVALID_LAST_NAME	Apellido de la persona inválido.
INVALID_COUNTRY_TYPE	País inválido.
INVALID_IDENTIFICATION_TYPE	Tipo de identificación fiscal inválido.
INVALID_IDENTIFICATION	Identificación fiscal inválido.
INVALID_MARIAL_STATE_TYPE	Estado civil inválido.
PERSON_IS_NOT_LEGAL_AGE	Menor de edad.
INVALID_DATE_FORMAT	Formato de fecha inválido.
INVALID_GENDER_TYPE	Género inválido.
IMPOSSIBLE_CREATE_ACCOUNT_IVSA_RESTRICTION	No se puede generar un usuario por restricción de IVSA.
INVALID_IVA_CONDITION_TYPE	Condición de IVA inválido.
INVALID_ADDRESS_TYPE	Tipo de dirección inválido.
INVALID_EMAIL	Email inválido.
INVALID_PHONE_NUMBER	Número de teléfono inválido.
INVALID_AREA_CODE_PHONE	Código de área telefónico inválido.
INVALID_STATE_TYPE	Provincia inválida.
INVALID_IDENTIFICATION_TYPE	Tipo de identification de un documento inválido.
INVALID_URL	Url de descarga de un documento inválida.
INVALID_BANKS_TYPE	Tipo de identificador de cuenta inválido.
INVALID_EMAIL	Email inválido.
INVALID_EMAIL	Email inválido.
INVALID_EMAIL	Email inválido.
INVALID_EMAIL	Email inválido.
INVALID_EMAIL	Email inválido.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Consulta detalle de una cuenta ¶

GET http://meli.d1c.pcnt.io/profile/v1/customer

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "identification": "31252804",
  "taxIdentification": "20312528046",
  "name": "Joel Marcos",
  "lastname": "del Valle",
  "bankIdentificationCvu": "0000003100154597617760",
  "account": "1000015",
  "bankIdentificationCbu": "3220001888006183780029"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Consultar cuenta
GET`/profile/v1/customer`

Se consulta el detalle de una cuenta

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta comitente que está invocando el servicio.

Es necesario mandar el número de cuenta en la url

Campo	Tipo	Descripción
account	String	Número de cuenta comitente

Response

Campo	Tipo	Descripción
identification	String	DNI
taxIdentification	String	CUIT
name	String	Nombre
lastname	String	Apellido
bankIdentificationCvu	String	CVU
account	String	Número de cuenta comitente
bankIdentificationCbu	String	CBU creada en el Bind

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
INVALID_CUSTOMER_SEARCH	No existe el número de cuenta.
INVALID_BANKS_SEARCH	La cuenta no tiene bancos vinculados.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Consulta cuenta habilitada para operar ¶

GET http://meli.d1c.pcnt.io/account-validator/v1/account/enabled

RequestsCuenta habilitadaCuenta inhabilitada

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "enabled": true
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "enabled": false,
  "detail": [
    "OP_COMEX_EXCH"
  ]
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Consulta cuenta habilitada para operar
GET`/account-validator/v1/account/enabled`

Se consulta si una cuenta esta disponible para operar

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta comitente que está invocando el servicio.

Response

Campo	Tipo	Descripción
enabled	Boolean	Determina si la cuenta esta o no habilitada
detail	Array	Array [String] Solo se visualiza si el campo enabled viene con valor 'false' ver listado

Listado de posibles causas
Códigp	Descripción
OP_LOAN_6937	Préstamos
OP_LOAN_6937_7006	Préstamos
OP_COMEX_EXCH	Operaciones de COMEX y cambios
OP_LOAN_POSTDATA	Préstamos con cuotas Posdatadas
OP_CEDEARS	Compró CEDEAR últimos 90 días
OP_TRANSF_TIT_EXT	Clientes con Transferencias de títulos valores al exterior Últimos 90 Días
OP_GUARANTEE	El cliente tiene cauciones tomadoras activas
OP_CREDITCARD_0_GRANTED	Elientes con Préstamos OTORGADOS a Tasa 0% Con tarjeta de Crédito
OP_CREDITCARD_REFINAN	El Cliente cuenta con refinanciaciones Vigentes TC
OP_CREDITCARD_0_AUTH	Préstamo Tasa %0 Autorizado
BLACKLIST_HIT	Hit en lista negra
ANTI_MONEY_LANDRYING	Posible lavado de dinero
NO_REQUIRED_DOCUMENTATION_PRESENT	PLD Bloqueo
HIT_BLACK_LIST	Hit en lista negra confirmado
OWNERSHIT_CHANGED	Cambio de titularidad
BLOQUEO_BASE_DE_CLIENTES	BC Bloqueo
BIND_DECISION_PLD	PLD Por decisión unilateral BIND
BLOQUEO_BC_PEP	BC Bloqueo PEP
BLOQUEO_BC_FATCA	BC Bloqueo FATCA
BLOQUEO_BC_SO	BC Bloqueo SO
BLOQUEO_BC_VTO_OPERADOR	BC Bloqueo Operador
BLOQUEO_BC_VTO_SOCIEDAD	BC Bloqueo Vto Sociedad
BLOQUEO_DDR_AUT	DDR Bloqueo Automatico
BLOQUEO_DDR_MAN	DDR Bloqueo Manual
BIND_DECISION_BC	C Por decisión unilateral BIND
BLOQUEO_AUT	DDC Bloqueo Automatico
BLOQUEO_MAN	DDC Bloqueo Manual
BIND_DECISION_DDC	DDC Por decisión unilateral BIND

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Marketdata ¶

Información de Mercado ¶

GET http://meli.d1c.pcnt.io/marketdata/v1/market/code/BYMA

RequestsMercado cerradoMercado abierto

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "name": "Bolsas y Mercados Argentinos",
  "schedules": {
    "T0": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": false
    },
    "T1": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": false
    },
    "T2": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": false
    }
  },
  "timeZone": "America/Argentina/Buenos_Aires",
  "locale": "es-AR",
  "nextOperationDate": "2024-08-06"
}

Responses409

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "name": "Bolsas y Mercados Argentinos",
  "schedules": {
    "T0": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": true
    },
    "T1": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": true
    },
    "T2": {
      "openTime": "11:00:00",
      "closeTime": "16:20:00",
      "open": true
    }
  },
  "timeZone": "America/Argentina/Buenos_Aires",
  "locale": "es-AR",
  "nextOperationDate": "2024-08-06"
}

Responses409

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Información de Mercado
GET`/marketdata/v1/market/code/BYMA`

Con este servicio se obtiene la información del mercado BYMA

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Response

Campo	Tipo	Descripción
name	String	Descripción
schedules	Array	Array [Term] ver Term
timeZone	String	Uso horario
locale	String	Locale
nextOperationDate	String	Próximo dia de operación

Term - Object
Campo	Tipo	Descripción
T0 / T1 / T2	Array	Array [Schedule] ver Schedule

Schedule - Object
Campo	Tipo	Descripción
openTime	String	Horario apertura
closeTime	String	Horario cierre
open	Boolean	Flag que determina si el mercado esta abierto o cerrado al momento de la consulta

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
MARKET_NOT_FOUND	Mercado inválido.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Dolar 1 Click ¶

Cotización Dólar MEP ¶

GET http://meli.d1c.pcnt.io/marketdata/v1/price/usdmep

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "buyPrice": 1481.82,
  "sellPrice": 1274.23,
  "timestamp": "2024-08-06T08:09:02Z"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Cotización Dólar MEP
GET`/marketdata/v1/price/usdmep`

Este servicio provee la cotización del Dólar MEP.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Response

Campo	Tipo	Descripción
buyPrice	Number	Precio de Compra
sellPrice	Number	Precio de Venta
timestamp	String	Timestamp de la cotización

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Obtener gastos para la Compra ¶

POST http://meli.d1c.pcnt.io/investment-operation-flow/v1/exchange/usdmep/preview/BUY

Requestsexample 1

Headers

organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "amount": 200700
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "amount": 200700,
  "gross": 198208,
  "net": 200224.72,
  "totalExpenses": 2016.72,
  "endOperationDate": "2024-08-07T12:00:00Z",
  "startOperationDate": "2024-08-06T12:00:00Z",
  "marketIsOpen": false,
  "totalExpensesCurrency": "ARS",
  "price": 1481.82
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Obtener gastos para Compra
POST`/investment-operation-flow/v1/exchange/usdmep/preview/BUY`

Este servicio permite obtener los gastos de una compra de Dólar MEP.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.

Request

Campo	Tipo	Descripción
amount	Number	Importe en pesos argentinos.

Response

Campo	Tipo	Descripción
amount	Number	Monto
gross	Number	Importe neto
net	Number	Importe bruto
totalExpenses	Number	Gastos totales de la operación
endOperationDate	String	Fecha en la cual la operación se completa al momento de la consulta
startOperationDate	String	Fecha en la cual la operación se inicia al momento de la consulta
marketIsOpen	Boolean	Determina si el mercado esta abierto o cerrado al momento de la consulta
totalExpensesCurrency	String	Moneda de los gastos retornados
price	Number	Precio aproximado de la operación

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
VALUE_MUST_BE_POSITIVE	El monto tiene que ser positivo.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Ingresar Compra ¶

POST http://meli.d1c.pcnt.io/investment-operation-flow/v1/exchange/usdmep/BUY

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "joel-test-uat-20240628-0010",
  "amount": 600000,
  "price": "1330.66",
  "disclaimer": {
    "accepted": true,
    "timestamp": "32321321312"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "operationId": "412412411"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Ingresar Compra
POST`/investment-operation-flow/v1/exchange/usdmep/BUY`

Este servicio permite realizar compra de Dólar MEP.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.
location	String	URL para enviar el webhook.

Request

Campo	Tipo	Descripción
thirdPartyId	Number	Id único externo.
amount	Number	Importe a invertir.
price	Number	Precio de referencia.
disclaimer	Object	Object [Disclaimer] ver Disclaimer

Disclaimer - Object
Campo	Tipo	Descripción
accepted	Boolean	Aceptación de las DDJJ
timestamp	String	Timestamp de la aceptación de las DDJJ

Response

Campo	Tipo	Descripción
operationId	String	Id de la operación.
endOperationDate	String	Fecha de fin de la operación.

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
DISCLAIMER_NOT_ACCEPTED	Las DDJJ no pueden ser rechazadas.
VALUE_MUST_BE_POSITIVE	El valor tiene que ser positivo.
ACCOUNT_DISABLED_TO_OPERATE	Cuenta inactiva.
CLOSED_MARKET	El mercado está cerrado.
CLOSED_OPERATION	Operación cerrada.
MONTHLY_SUM_EXCEEDED	Se supero el máximo permitido para operar en el mes.
INVALID_MIN_USD	Cantidad mínima de dolares a comprar no permitida.
OUTDATED_REFERENCE_PRICE	Precios desfasados entre lo que envia meli y lo que retorna el mercado al momento de recibir la petición.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Webhook - Compra USD - Pata 1

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"00014fuk9x",
   "external_id":"1270022436872830976",
   "status":"APPROVED",
   "amount":599605.1600000000
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.
amount	Number	Monto.

Webhook - Compra USD - Pata 2

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"00014j8x7a",
   "external_id":"1270384740564017152",
   "status":"EXCHANGED",
   "amount":2.3500000000,
   "exchange_amount":3119.6600000000
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.
amount	Number	Monto.
exchange_amount	Number	Monto convertido.

Webhook - Venta USD - Pata 1

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"00014j8x7a",
   "external_id":"1270384740564017152",
   "status":"EXCHANGED",
   "amount":2.3500000000,
   "exchange_amount":3119.6600000000
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.
amount	Number	Monto.
exchange_amount	Number	Monto convertido.

Obtener gastos para la Venta ¶

POST http://meli.d1c.pcnt.io/investment-operation-flow/v1/exchange/usdmep/preview/SELL

Requestsexample 1

Headers

organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "amount": 15
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "amount": 15,
  "gross": 14.7,
  "net": 14.85,
  "totalExpenses": 191.13,
  "endOperationDate": "2024-08-06T12:00:00Z",
  "startOperationDate": "2024-08-06T12:00:00Z",
  "marketIsOpen": false,
  "totalExpensesCurrency": "USD",
  "price": 1274.23
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Obtener gastos para Venta
POST`/investment-operation-flow/v1/exchange/usdmep/preview/SELL`

Este servicio permite obtener los gastos de una venta de Dólar MEP.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.

Request

Campo	Tipo	Descripción
amount	Number	Importe en pesos argentinos.

Response

Campo	Tipo	Descripción
amount	Number	Monto
gross	Number	Importe neto
net	Number	Importe bruto
totalExpenses	Number	Gastos totales de la operación
endOperationDate	String	Fecha en la cual la operación se completa al momento de la consulta
startOperationDate	String	Fecha en la cual la operación se inicia al momento de la consulta
marketIsOpen	Boolean	Determina si el mercado esta abierto o cerrado al momento de la consulta
totalExpensesCurrency	String	Moneda de los gastos retornados
price	Number	Precio aproximado de la operación

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
VALUE_MUST_BE_POSITIVE	El monto tiene que ser positivo.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Ingresar Venta ¶

POST http://meli.d1c.pcnt.io/investment-operation-flow/v1/exchange/usdmep/SELL

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "joel-test-uat-20240628-0010",
  "amount": 240,
  "price": "1330.66",
  "disclaimer": {
    "accepted": true,
    "timestamp": "32321321312"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "operationId": "412412411"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Ingresar Venta
POST`/investment-operation-flow/v1/exchange/usdmep/SELL`

Este servicio permite realizar venta de Dólar MEP.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.
location	String	URL para enviar el webhook.

Request

Campo	Tipo	Descripción
thirdPartyId	Number	Id único externo.
amount	Number	Importe a invertir.
price	Number	Precio de referencia.
disclaimer	Object	Object [Disclaimer] ver Disclaimer

Disclaimer - Object
Campo	Tipo	Descripción
accepted	Boolean	Aceptación de las DDJJ
timestamp	String	Timestamp de la aceptación de las DDJJ

Response

Campo	Tipo	Descripción
operationId	String	Id de la operación.
endOperationDate	String	Fecha de fin de la operación.

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
DISCLAIMER_NOT_ACCEPTED	Las DDJJ no pueden ser rechazadas.
VALUE_MUST_BE_POSITIVE	El valor tiene que ser positivo.
ACCOUNT_DISABLED_TO_OPERATE	Cuenta inactiva.
CLOSED_MARKET	El mercado está cerrado.
CLOSED_OPERATION	Operación cerrada.
NOT_MONEY_AVAILABLE	Saldo insuficiente.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Obtener Operación ¶

GET http://meli.d1c.pcnt.io/investment-operation-flow/v1/exchange

RequestsConsulta de una operación existosaConsulta de una operación con error

Headers

organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "0000tbx5oa",
  "amount": 1100000,
  "account": "1680043",
  "state": "EXCHANGED",
  "result": {
    "totalInvested": 1099048.91,
    "totalObtained": 979.24
  },
  "id": "27293924800256",
  "operation": "BUY",
  "startDate": "2024-05-20T18:58:21",
  "endDate": "2024-05-21T19:10:27",
  "relatedOperations": [
    {
      "instrument": "BYMA.AL30",
      "term": "T0",
      "state": "FILLED",
      "amount": 1088396.1,
      "quantity": 1683,
      "cumQuantity": 1683,
      "leavesQuantity": 0,
      "expenses": {
        "byMarket": 108.81,
        "byOperation": 10880.6,
        "total": 10989.41
      },
      "finalAmount": 1088059.5,
      "finalQuantity": 1683,
      "date": "2024-05-20T18:58:38",
      "currency": "ARS",
      "operation": "BUY"
    },
    {
      "instrument": "BYMA.AL30D",
      "term": "T0",
      "state": "FILLED",
      "quantity": 1683,
      "cumQuantity": 1683,
      "leavesQuantity": 0,
      "expenses": {
        "byMarket": 0.1,
        "byOperation": 0,
        "total": 0.1
      },
      "finalAmount": 979.34,
      "finalQuantity": 1683,
      "date": "2024-05-21T14:38:49",
      "currency": "USD",
      "operation": "SELL"
    }
  ]
}

Responses409

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "thirdPartyId": "0000tbx5oa",
  "amount": 1100000,
  "account": "1680043",
  "state": "ERROR",
  "result": {
    "totalInvested": 0,
    "totalObtained": 0
  },
  "id": "27293924800256",
  "operation": "BUY",
  "startDate": "2024-05-20T18:58:21",
  "endDate": "2024-05-21T19:10:27",
  "relatedOperations": []
}

Responses409

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Obtener Operación
GET`/investment-operation-flow/v1/exchange`

Con este servicio se obtiene el estado y detalle de una operación.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.

Query params

Campo	Tipo	Descripción
thirdPartyId	String	Id externo.
operationId	String	Id de operación.

Response

Campo	Tipo	Descripción
thirdPartyId	String	Id externo.
amount	Number	Monto.
account	String	Número de cuenta comitente.
state	String	Estado. Posibles valores: REGISTERED APPROVED EXCHANGED ERROR
result	Object	Object [Result] ver Result
operation	String	Tipo de operación. Posibles valores: BUY SELL
id	String	Id de operación
startDate	String	Fecha de inicio de la operación
endDate	String	Fecha de fin de la operación.
instrumentDescription	String	Descripción del instrumento.
relatedOperations	Array	Array [RelatedOperations] ver RelatedOperations

Result - Object
Campo	Tipo	Descripción
totalInvested	Number	Monto total invertido
totalObtained	Number	Monto total obtenido

Result - RelatedOperations
Campo	Tipo	Descripción
instrument	String	Instrumento
term	String	Plazo
state	String	Estado
amount	Number	Monto
quantity	Number	Cantidad
cumQuantity	Number	Cantidad acumulada
leavesQuantity	Number	Cantidad restante
expenses	Object	Object [Expenses] ver Expenses
finalQuantity	Number	Cantidad final
finalAmount	Number	Monto final
operation	String	Tipo de operación. Posibles valores: BUY SELL
currency	String	Moneda
date	String	Fecha

Expenses - Object
Campo	Tipo	Descripción
byMarket	Number	Gastos de mercado
byOperation	Number	Gastos de negocio
total	Number	Total gastos

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
INVALID_OPERATION	Operación inválida.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Consulta de una declaración jurada ¶

GET http://meli.d1c.pcnt.io/investment-operation-flow/v1/disclaimer/usdmep

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "disclaimer": "Según Comunicación A 7552 BCRA declaro que en los últimos 90 días corridos no he accedido al mercado de cambios para la compra de moneda extranjera (incluyendo canjes o arbitrajes) ni me encuentro alcanzado por ninguna restricción legal o reglamentaria para efectuar la operación.",
  "createdDate": "2023-11-16 11:43:43",
  "key": "D1C_OPERATION"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Consulta de una declaración jurada
GET`/investment-operation-flow/v1/disclaimer/usdmep`

Con este servicio se obtienen la declaración jurada.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio

Response

Disclaimer - Object
Campo	Tipo	Descripción
disclaimer	String	Contenido de la DDJJ
createdDate	String	Fecha de creación
key	String	Id único

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
DICLAIMER_NOT_AVAILABLE	DDJJ no disponible.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Operación activa ¶

GET http://meli.d1c.pcnt.io/investment-operation-flow/v1/operation/enabled

RequestsOperación activaOperación inactiva

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "enabled": true
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "enabled": false
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Operación activa
GET`/investment-operation-flow/v1/operation/enabled`

Este servicio provee si el producto D1C esta activo para su uso.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Response

Campo	Tipo	Descripción
enabled	Boolean	Activo

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Cuenta Remunerada USD ¶

Cotización Fondo MM USD ¶

GET http://meli.d1c.pcnt.io/marketdata/v1/price/fund/12345

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "code": "1483",
  "price": 1.55,
  "date": "2024-10-01",
  "currency": "USD",
  "class": "A"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Cotización Fondo MM USD
GET`/marketdata/v1/price/fund/12345`

Este servicio provee la cotización del Fondo MM USD.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Response

Campo	Tipo	Descripción
code	String	Código del Fondo MM
price	Number	Valor de cuotaparte
date	String	Fecha
currency	String	Moneda
class	String	Categoría del fondo

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Suscripciones ¶

POST http://meli.d1c.pcnt.io/investment/operate/fund/bulk/SUBSCRIPTION

Requestssuscripcion por monto

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "datetime": "2012-11-21T03:00:00Z",
  "total": {
    "data_size": 1,
    "total_amount": "30500.30"
  },
  "data": [
    {
      "fund": "2",
      "account": "4652",
      "value": {
        "amount": "30500.30"
      },
      "third_party_information": {
        "id": "123",
        "transaction_id": "trx-1342-232SAF",
        "detail": "texto libre"
      }
    }
  ],
  "third_party_information": {
    "packet_id": "ewqeq_312321_3123_edewqeq",
    "type": "A",
    "description": "descripción del paquete"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "created_datetime": "2012-11-21T03:00:00Z",
  "bundle_id": "43",
  "packet_id": "1234",
  "total_request": 1
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Suscripciones
POST`/investment/operate/fund/bulk/SUBSCRIPTION`

Este servicio provee información para poder enviar suscripciones al fondo

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Request

Campo	Tipo	Descripción
datetime	String	Fecha
total	Object	Object IntegrityDataTotal ver IntegrityDataTotal
data	Object	Object [Data] ver Data
third_party_information	Object	Object ThirdPartyInformation ver ThirdPartyInformation

IntegrityDataTotal - Object
Campo	Tipo	Descripción
data_size	Integer	Cantidad de operaciones
total_amount	String	Sumatoria total del monto de las operaciones

ThirdPartyInformation - Object
Campo	Tipo	Descripción
packet_id	String	Id externo del packet
type	String	Tipo
description	String	Descripción

Data - Object
Campo	Tipo	Descripción
fund	String	Código del fondo
account	String	Cuenta de inversión
value	Object	Object DataValue ver DataValue
third_party_information	Object	Object ThirdPartyInformation ver ThirdPartyInformation

DataValue - Object
Campo	Tipo	Descripción
amount	String	Monto

ThirdPartyInformation - Object
Campo	Tipo	Descripción
id	String	Id externo de la operación
transaction_id	String	Id externo de la transacción
detail	String	Descripción

Rescates ¶

POST http://meli.d1c.pcnt.io/investment/operate/fund/bulk/WITHDRAW

Requestsrescate por montorescate total

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "datetime": "2012-11-21T03:00:00Z",
  "total": {
    "data_size": 1,
    "total_amount": "30500.30"
  },
  "data": [
    {
      "fund": "2",
      "account": "4652",
      "value": {
        "amount": "30500.30"
      },
      "third_party_information": {
        "id": "123",
        "transaction_id": "trx-1342-232SAF",
        "detail": "texto libre"
      }
    }
  ],
  "third_party_information": {
    "packet_id": "ewqeq_312321_3123_edewqeq",
    "type": "A",
    "description": "descripción del paquete"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "created_datetime": "2012-11-21T03:00:00Z",
  "bundle_id": "43",
  "packet_id": "1234",
  "total_request": 1
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Headers

Content-Type: application/json
organization: <organization>
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "datetime": "2012-11-21T03:00:00Z",
  "total": {
    "data_size": 1,
    "total_amount": "0"
  },
  "data": [
    {
      "fund": "2",
      "account": "4652",
      "value": {
        "totalWithdraw": true
      },
      "third_party_information": {
        "id": "123",
        "transaction_id": "trx-1342-232SAF",
        "detail": "texto libre"
      }
    }
  ],
  "third_party_information": {
    "packet_id": "ewqeq_312321_3123_edewqeq",
    "type": "A",
    "description": "descripción del paquete"
  }
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "created_datetime": "2012-11-21T03:00:00Z",
  "bundle_id": "43",
  "packet_id": "1234",
  "total_request": 1
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Rescates
POST`/investment/operate/fund/bulk/WITHDRAW`

Este servicio provee información para poder enviar rescates al fondo

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.

Request

Campo	Tipo	Descripción
datetime	String	Fecha
total	Object	Object IntegrityDataTotal ver IntegrityDataTotal
data	Object	Object [Data] ver Data
third_party_information	Object	Object ThirdPartyInformation ver ThirdPartyInformation

IntegrityDataTotal - Object
Campo	Tipo	Descripción
data_size	Integer	Cantidad de operaciones
total_amount	String	Sumatoria total del monto de las operaciones

ThirdPartyInformation - Object
Campo	Tipo	Descripción
packet_id	String	Id externo del packet
type	String	Tipo
description	String	Descripción

Data - Object
Campo	Tipo	Descripción
fund	String	Código del fondo
account	String	Cuenta de inversión
value	Object	Object DataValue ver DataValue
third_party_information	Object	Object ThirdPartyInformation ver ThirdPartyInformation

DataValue - Object
Campo	Tipo	Descripción
amount	String	Monto
totalWithdraw	Boolean	Rescate total

ThirdPartyInformation - Object
Campo	Tipo	Descripción
id	String	Id externo de la operación
transaction_id	String	Id externo de la transacción
detail	String	Descripción

Tesoreria ¶

Extracción de dinero ¶

POST http://meli.d1c.pcnt.io/cash-management/v1/transaction/OUT

RequestsEnvio de dinero

Headers

organization: <organization>
account: 1802
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "currency": "USD",
  "identificationBankAccount": "0720432088000036009622",
  "amount": 0.01,
  "thirdPartyId": "prueba-cash-out-913502"
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "uniqueId": "1266122743860322304",
  "originBankAccount": {
    "identification": "3220001812000036580135",
    "account": "12000036580135",
    "taxIdentification": "30642023876",
    "name": "IVSA"
  }
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

{
    "code": "INVALID_BANK_ACCOUNT_IDENTIFICATION",
    "message": "Error in field: identificationBankAccount",
    "process": "1297944803973484544"
}

{
    "code": "INVALID_CURRENCY",
    "message": "Error in field: currency",
    "process": "1298368615609225216"
}

Extracción de dinero
POST`/cash-management/v1/transaction/OUT`

Esta api permite el envio de dinero a la cuenta bancaria cargada en la cuenta comitente.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta que está invocando el servicio
location	String	URL para enviar el webhook.

Request

Campo	Tipo	Descripción
currency	String	Moneda
amount	Number	Monto
identificationBankAccount	String	CBU / CVU a la cual debe enviarse el dinero
thirdPartyId	Number	Id externo

Response

Campo	Tipo	Descripción
uniqueId	String	Id único
originBankAccount	Object	Object [OriginBankAccount] ver OriginBankAccount

OriginBankAccount - Object
Campo	Tipo	Descripción
identification	String	CBU origien de la operación
account	String	Cuenta origien de la operación
taxIdentification	String	CUIT origien de la operación
name	String	Nombre origien de la operación

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
NOT_MONEY_AVAILABLE	No dispone de dinero.
INVALID_BANK_ACCOUNT_IDENTIFICATION	Cuenta bancaria inválida.
INVALID_CURRENCY	Moneda inválida.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Webhook - Proceso OK

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"4108790013120",
   "state":"CONCILIATION",
   "thirdPartyId":"CPO70354163788"
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.

Webhook - Proceso ERROR

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"1270716284670738432",
   "state":"ERROR",
   "thirdPartyId":"CPO84652607424",
   "errorDetail": { 
        "final":false,
        "code":"GENERAL_ERROR"
   }
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.
errorDetail	Object	Object [ErrorDetail] ver ErrorDetail

ErrorDetail - Object
Campo	Tipo	Descripción
code	String	Código ver listado
final	String	Es reintentable

Consulta extracción de dinero ¶

GET http://meli.d1c.pcnt.io/cash-management/v1/transaction

RequestsConsulta envio de dinero

Headers

organization: <organization>
account: 1802
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "id": "1270455805277278208",
  "state": "ERROR",
  "errorDetail": {
    "code": "APIBANK_VALIDATION_ERROR",
    "final": true
  },
  "thirdPartyId": "joel-test-uat-20240731-04"
}

Responses200409

Headers

Content-Type: application/json

Body

{
    "id": "3256651256",
    "state": "ACCEPTED",
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

Consulta extracción de dinero
GET`/cash-management/v1/transaction`

Esta api permite el envio de dinero a la cuenta bancaria cargada en la cuenta comitente.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta que está invocando el servicio

Query params

Campo	Tipo	Descripción
thirdPartyId	String	Id externo.
transactionId	String	Id de operación.

Response

Campo	Tipo	Descripción
id	String	Id único
state	String	Estado Posibles valores: PENDING ERROR CONCILIATION
thirdPartyId	String	Id externo
errorDetail	Object	Object [ErrorDetail] ver ErrorDetail

ErrorDetail - Object
Campo	Tipo	Descripción
code	String	Código ver listado
final	String	Es reintentable

Listado de errores
Código	Descripción	Es reintentable
APIBANK_VALIDATION_ERROR	Código	Código
APIBANK_INVALID_DESTINATION_ACCOUNT	Es reintentable	Si
APIBANK_INVALID_CBU_CVU	Es reintentable	Si
APIBANK_INVALID_ALIAS	Es reintentable	Si
EXTERNAL_REJECTION_INEXISTENT_CBU	Es reintentable	Si
ERROR_APIBANK_DESTINATION_ACCOUNT_CANT_RECEIVE_TRANSFER	Es reintentable	Si
EXTERNAL_REJECTION_INVALID_CBU	Es reintentable	Si
EXTERNAL_REJECTION_CBU_NOT_ENABLED_FOR_BANKING_NET	Es reintentable	Si
APIBANK_GENENERAL_ERROR	Es reintentable	No
APIBANK_EXTERNAL_NETS_ARE_UNAVAILABLE	Es reintentable	No
ERROR_TO_PROCESS_OPERATION	Es reintentable	No
GENERIC_ERROR	Es reintentable	No
GENERIC_INTERNAL_ERROR	Es reintentable	No
ERROR_READ_TIME_OUT	Es reintentable	No
ERROR_TIME_OUT	Es reintentable	No
CONNECTION_ERROR	Es reintentable	No
ERROR_TO_PROCESS_TRANSFER	Es reintentable	No
ERROR_CHECK_CBU	Es reintentable	No
ERROR_BANELCO_RESPONSE_DONT_KNOW	Es reintentable	No
UNKNOW_GENERAL_ERROR	Es reintentable	No

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_LOGIN	Acceso inválido.
INVALID_BANK_TRANSACTION	Operación inválida.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

P2P ¶

Realizar transferencia P2P ¶

POST http://meli.d1c.pcnt.io/cash-management/v1/p2p/transfer

RequestsRealizar transferencia P2P

Headers

organization: <organization>
account: 1802
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "currency": "USD",
  "destinationAccount": "7108",
  "amount": 10,
  "thirdPartyId": "joel-p2p-0005"
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "uniqueId": "123456789"
}

Headers

Content-Type: application/json

Body

{
    "code": "INVALID_CURRENCY",
    "message": "Error in field: currency",
    "process": "1296929556928090112"
}

{
    "code": "NOT_MONEY_AVAILABLE",
    "process": "1296928429226545152"
}

Realizar transferencia P2P
POST`/cash-management/v1/p2p/transfer`

Este servicio permite el envio de dinero a través de una transferencia P2P

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta que está invocando el servicio
location	String	URL para enviar el webhook.

Request

Campo	Tipo	Descripción
thirdPartyId	Number	Id único externo.
amount	Number	Importe a invertir.
currency	String	Moneda
destinationAccount	String	Cuenta destinataria

Response

Campo	Tipo	Descripción
uniqueId	String	Id único
errorDetail	Object	Object [ErrorDetail] ver ErrorDetail

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
NOT_MONEY_AVAILABLE	No hay dinero en la cuenta
REQUIRED_FIELD_WITH_NULL_VALUE	Operación inválida.
INVALID_CURRENCY	Moneda inválida

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Webhook - Proceso OK

Información definida y provista por el equipo de Mercado Libre.

                {
                    "id":"4108790013120",
                    "state":"CONCILIATION",
                    "thirdPartyId":"CPO70354163788"
                }

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.

Webhook - Proceso ERROR

Información definida y provista por el equipo de Mercado Libre.

{
   "id":"1270716284670738432",
   "state":"ERROR",
   "thirdPartyId":"CPO84652607424",
   "errorDetail": { 
        "final":false,
        "code":"GENERAL_ERROR"
   }
}

Campo	Tipo	Descripción
id	String	Id único.
external_id	String	Id externo.
status	String	Estado.
errorDetail	Object	Object [ErrorDetail] ver ErrorDetail

ErrorDetail - Object
Campo	Tipo	Descripción
code	String	Código ver listado
final	String	Es reintentable

Obtener detalles de la transferencia P2P ¶

GET http://meli.d1c.pcnt.io/cash-management/v1/p2p

RequestsObtener detalles de la transferencia P2P

Headers

organization: <organization>
account: 1802
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Responses200409

Headers

Content-Type: application/json

Body

{
  "startDate": "2024-07-23 10:28:27.000",
  "endDate": "2024-07-23 10:30:26.000",
  "originAccount": "7091",
  "destinationAccount": "7108",
  "currency": "USD",
  "sentAmount": 1,
  "status": "PROCESSED",
  "uniqueId": "1265299495371112448",
  "thirdPartyId": "joel-p2p-0005"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "1296916182169243648"
}

{
"code": "INVALID_PEER_TO_PEER_TRANSFER",
"process": "1296921571233320960"
}

Obtener detalles de la transferencia P2P
GET`/cash-management/v1/p2p`

Este servicio permite obtener el detalle de una transferencia P2P

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token"
organization	String	Siglas de la organización que está invocando el servicio
account	String	Número de cuenta que está invocando el servicio

Query params

Campo	Tipo	Descripción
thirdPartyId	String	Id externo.
transactionId	String	Id de operación.

Response

Campo	Tipo	Descripción
startDate	String	Fecha de inicio
endDate	String	Fecha de fin
originAccount	String	Cuenta de origen
destinationAccount	String	Cuenta de destino
currency	String	Moneda
sentAmount	Number	Cantidad enviada
status	String	Estado de la transacción
uniqueId	String	Id único
thirdPartyId	String	Id externo
state	String	Estado Posibles valores: PENDING ERROR PROCESSED
errorDetail	Object	Object [ErrorDetail] ver ErrorDetail

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
INVALID_PEER_TO_PEER_TRANSFER	Cuenta P2P inválida.

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

CAP ¶

Cambio de perfil transaccional ¶

POST http://meli.d1c.pcnt.io/investment-operation-flow/v1/cap/change

RequestsEjemplo

Headers

Content-Type: application/json
organization: <organization>
account: 101357
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A

Body

{
  "income_amount": 1000.5,
  "upload_date": "2024-10-21T10:00:00Z",
  "documents": [
    "document1.pdf",
    "document2.pdf"
  ]
}

Responses200409

Headers

Content-Type: application/json

Body

{
  "uniqueId": "1265296147712167936"
}

Headers

Content-Type: application/json

Body

{
    "code": "GENERAL_ERROR",
    "process": "948595173290356736",
}

{
    "code": "LIST_IS_EMPTY",
    "message": "Error in field: documents",
    "process": "1297923355284295680"
}

Cambio de perfil transaccional
POST`/investment-operation-flow/v1/cap/change`

Permite el cambio del perfil transaccional.

Header

Campo	Tipo	Descripción
Content-Type	String	application/json
Authorization	String	Contiene el JWT de autenticación Valores permitidos: "JWT :token".
organization	String	Siglas de la organización que está invocando el servicio.
account	String	Número de cuenta comitente que está invocando el servicio.

Request

Campo	Tipo	Descripción
incomeAmount	Number	Importe de ingresos.
uploadDate	String	Fecha de subida de los documentos
documents	Array[String]	Listado de documentos requeridos para realizar el cambio de perfil

Response

Campo	Tipo	Descripción
uniqueId	String	Id único

Posibles errores

Código	Descripción
GENERAL_ERROR	Error genérico.
LIST_IS_EMPTY	Lista de documentos vacía

Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.

Errores ¶

Formato

Todos los errores controlados retornan con HTTP 409 y el siguiente formato de respuesta:

{ 
   "code": "GENERAL_ERROR", 
   "process": "948595173290356736",
   "message": "Debe introducir una fecha válida"
}

Anexo Códigos ¶

Condición ganancias

Ver listado

Código	Descripción
EXE	Excento
INS	Inscripto
NOINS	No Inscripto

Condición IVA

Ver listado

Código	Descripción
RI	Responsable Inscripto
RNI	Responsable No Inscripto
EX	Excento
RM	Responsable Monotributista
CF	Consumidor Final

Provincias

Ver listado

Código	Descripción
AR-C	Ciudad Autónoma de Buenos Aires
AR-B	Buenos Aires
AR-K	Catamarca
AR-H	Chaco
AR-U	Chubut
AR-X	Córdoba
AR-W	Corrientes
AR-E	Entre Ríos
AR-P	Formosa
AR-Y	Jujuy
AR-L	La Pampa
AR-F	La Rioja
AR-M	Mendoza
AR-N	Misiones
AR-Q	Neuquén
AR-R	Río Negro
AR-A	Salta
AR-J	San Juan
AR-D	San Luis
AR-Z	Santa Cruz
AR-S	Santa Fe
AR-G	Santiago del Estero
AR-V	Tierra del Fuego, Antártida e Islas del Atlántico Sur
AR-T	Tucumán

Países

VER LISTADO

Código	Descripción
AF	Afghanistan
AX	Åland Islands
AL	Albania
DZ	Algeria
AS	American Samoa
AD	Andorra
AO	Angola
AI	Anguilla
AQ	Antarctica
AG	Antigua and Barbuda
AR	Argentina
AM	Armenia
AW	Aruba
AU	Australia
AT	Austria
AZ	Azerbaijan
BS	Bahamas
BH	Bahrain
BD	Bangladesh
BB	Barbados
BY	Belarus
BE	Belgium
BZ	Belize
BJ	Benin
BM	Bermuda
BT	Bhutan
BO	Bolivia
BA	Bosnia and Herzegovina
BW	Botswana
BV	Bouvet Island
BR	Brazil
IO	British Indian Ocean Territory
BN	Brunei Darussalam
BG	Bulgaria
BF	Burkina Faso
BI	Burundi
KH	Cambodia
CM	Cameroon
CA	Canada
CV	Cape Verde
KY	Cayman Islands
CF	Central African Republic
TD	Chad
CL	Chile
CN	China
CX	Christmas Island
CC	Cocos (Keeling) Islands
CO	Colombia
KM	Comoros
CG	Congo
CD	Congo, The Democratic Republic of the
CK	Cook Islands
CR	Costa Rica
CI	Cote D'Ivoire
HR	Croatia
CU	Cuba
CY	Cyprus
CZ	Czech Republic
DK	Denmark
DJ	Djibouti
DM	Dominica
DO	Dominican Republic
EC	Ecuador
EG	Egypt
SV	El Salvador
GQ	Equatorial Guinea
ER	Eritrea
EE	Estonia
ET	Ethiopia
FK	Falkland Islands (Malvinas)
FO	Faroe Islands
FJ	Fiji
FI	Finland
FR	France
GF	French Guiana
PF	French Polynesia
TF	French Southern Territories
GA	Gabon
GM	Gambia
GE	Georgia
DE	Germany
GH	Ghana
GI	Gibraltar
GR	Greece
GL	Greenland
GD	Grenada
GP	Guadeloupe
GU	Guam
GT	Guatemala
GG	Guernsey
GN	Guinea
GW	Guinea-Bissau
GY	Guyana
HT	Haiti
HM	Heard Island and Mcdonald Islands
VA	Holy See (Vatican City State)
HN	Honduras
HK	Hong Kong
HU	Hungary
IS	Iceland
IN	India
ID	Indonesia
IR	Iran, Islamic Republic Of
IQ	Iraq
IE	Ireland
IM	Isle of Man
IL	Israel
IT	Italy
JM	Jamaica
JP	Japan
JE	Jersey
JO	Jordan
KZ	Kazakhstan
KE	Kenya
KI	Kiribati
KP	Korea, Democratic People's Republic of
KR	Korea, Republic of
KW	Kuwait
KG	Kyrgyzstan
LA	Lao People's Democratic Republic
LV	Latvia
LB	Lebanon
LS	Lesotho
LR	Liberia
LY	Libyan Arab Jamahiriya
LI	Liechtenstein
LT	Lithuania
LU	Luxembourg
MO	Macao
MK	Macedonia, The Former Yugoslav Republic of
MG	Madagascar
MW	Malawi
MY	Malaysia
MV	Maldives
ML	Mali
MT	Malta
MH	Marshall Islands
MQ	Martinique
MR	Mauritania
MU	Mauritius
YT	Mayotte
MX	Mexico
FM	Micronesia, Federated States of
MD	Moldova, Republic of
MC	Monaco
MN	Mongolia
MS	Montserrat
MA	Morocco
MZ	Mozambique
MM	Myanmar
NA	Namibia
NR	Nauru
NP	Nepal
NL	Netherlands
AN	Netherlands Antilles
NC	New Caledonia
NZ	New Zealand
NI	Nicaragua
NE	Niger
NG	Nigeria
NU	Niue
NF	Norfolk Island
MP	Northern Mariana Islands
NO	Norway
OM	Oman
PK	Pakistan
PW	Palau
PS	Palestinian Territory, Occupied
PA	Panama
PG	Papua New Guinea
PY	Paraguay
PE	Peru
PH	Philippines
PN	Pitcairn
PL	Poland
PT	Portugal
PR	Puerto Rico
QA	Qatar
RE	Reunion
RO	Romania
RU	Russian Federation
RW	RWANDA
SH	Saint Helena
KN	Saint Kitts and Nevis
LC	Saint Lucia
PM	Saint Pierre and Miquelon
VC	Saint Vincent and the Grenadines
WS	Samoa
SM	San Marino
ST	Sao Tome and Principe
SA	Saudi Arabia
SN	Senegal
CS	Serbia and Montenegro
SC	Seychelles
SL	Sierra Leone
SG	Singapore
SK	Slovakia
SI	Slovenia
SB	Solomon Islands
SO	Somalia
ZA	South Africa
GS	South Georgia and the South Sandwich Islands
ES	Spain
LK	Sri Lanka
SD	Sudan
SR	Suriname
SJ	Svalbard and Jan Mayen
SZ	Swaziland
SE	Sweden
CH	Switzerland
SY	Syrian Arab Republic
TW	Taiwan, Province of China
TJ	Tajikistan
TZ	Tanzania, United Republic of
TH	Thailand
TL	Timor-Leste
TG	Togo
TK	Tokelau
TO	Tonga
TT	Trinidad and Tobago
TN	Tunisia
TR	Turkey
TM	Turkmenistan
TC	Turks and Caicos Islands
TV	Tuvalu
UG	Uganda
UA	Ukraine
AE	United Arab Emirates
GB	United Kingdom
US	United States
UM	United States Minor Outlying Islands
UY	Uruguay
UZ	Uzbekistan
VU	Vanuatu
VE	Venezuela
VN	Viet Nam
VG	Virgin Islands, British
VI	Virgin Islands, U.S.
WF	Wallis and Futuna
EH	Western Sahara
YE	Yemen
ZM	Zambia
ZW	Zimbabwe"

Tipos de instrumento

Ver listado

Código	Descripción
EQUITY	Acción
CERTIFICATE	Cedear
BOND	Bono

Formatos de declaraciones juradas

Ver listado

Código	Descripción
PLAIN_TEXT	Declaración Jurada en formato texto plano.
LINK	Link a la declaración jurada en formato PDF.
PDF	Archivo PDF de la declración Jurada.
HTML	Declaración Jurada en formato html.

Plazos

Ver listado

Código	Descripción
T0	C.I. (Contado Inmediato)
T1	24hs
T2	48hs

Cuenta tipos de estado

VER LISTADO

Código	Descripción
INACTIVE	Inactivo
ACTIVE	Activo

Generated by aglio on 22 Oct 2024

API Endpoint

Introduction ¶

Autenticación ¶

Headers ¶

ThirdPartyId ¶

Organization ¶

Auth ¶

Login ¶

Headers

Body

Headers

Body

Headers

Body

Headers

Body

Autenticarse en pcnt d1cPOST/profile/v1/login/api

Cuenta ¶

Creación de cuenta ¶

Headers

Body

Headers

Body

Headers

Body

Headers

Body

Headers

Body

Headers

Body

Creación de cuentaPOST/profile/v1/account

Consulta detalle de una cuenta ¶

Headers

Headers

Body

Headers

Body

Consultar cuentaGET/profile/v1/customer

Es necesario mandar el número de cuenta en la url

Consulta cuenta habilitada para operar ¶

Headers

Headers

Body

Headers

Body

Headers

Headers

Body

Headers

Body

Consulta cuenta habilitada para operarGET/account-validator/v1/account/enabled

Marketdata ¶

Información de Mercado ¶

Headers

Body

Body

Headers

Body

Body

Información de MercadoGET/marketdata/v1/market/code/BYMA

Dolar 1 Click ¶

Cotización Dólar MEP ¶

Headers

Headers

Body

Headers

Body

Cotización Dólar MEPGET/marketdata/v1/price/usdmep

Obtener gastos para la Compra ¶

Headers

Body

Headers

Body

Headers

Body

Obtener gastos para CompraPOST/investment-operation-flow/v1/exchange/usdmep/preview/BUY

Ingresar Compra ¶

Headers

Body

Autenticación

Headers

ThirdPartyId

Organization

Autenticarse en pcnt d1c
POST`/profile/v1/login/api`

Creación de cuenta
POST`/profile/v1/account`

Consultar cuenta
GET`/profile/v1/customer`

Consulta cuenta habilitada para operar
GET`/account-validator/v1/account/enabled`

Información de Mercado
GET`/marketdata/v1/market/code/BYMA`

Cotización Dólar MEP
GET`/marketdata/v1/price/usdmep`

Obtener gastos para Compra
POST`/investment-operation-flow/v1/exchange/usdmep/preview/BUY`

Ingresar Compra
POST`/investment-operation-flow/v1/exchange/usdmep/BUY`

Obtener gastos para Venta
POST`/investment-operation-flow/v1/exchange/usdmep/preview/SELL`

Ingresar Venta
POST`/investment-operation-flow/v1/exchange/usdmep/SELL`

Obtener Operación
GET`/investment-operation-flow/v1/exchange`

Consulta de una declaración jurada
GET`/investment-operation-flow/v1/disclaimer/usdmep`

Operación activa
GET`/investment-operation-flow/v1/operation/enabled`

Cotización Fondo MM USD
GET`/marketdata/v1/price/fund/12345`

Suscripciones
POST`/investment/operate/fund/bulk/SUBSCRIPTION`