masstack

Glossary

Errors

This section describes most of the possible errors that our APIs may return, their cause, and explanation.

Signups

These are errors that could be raised using the signups endpoints.
Some of those endpoints can be used in many different ways and, depending on the request body, different actions can be performed.
Below you can find a list of the various exceptions thrown, their messages, and explanation in the following format

### `Exception`
- "Message 1"
    - Explanation 1
- "Message 2"
    - Explanation 2

BadRequestException

  • “Tenant is mandatory”
    • The tenant is not present in the path
  • “Error en el proceso de venta, en esta dirección ya existe una orden activa”
    • The request is ok but the address already has an order in progress
  • “Error registrando el pago de la venta. MySim RegisterSellPayment socket error. StatusCode:”
    • The service processed the request but the downstream backend returned an error

IllegalArgumentException

  • “error mapping request”
    • The request body could not be mapped because there are missing parameters or their format is wrong.

ValidateRequestSignupException

  • “Error mapping request”
    • The request body is not valid because of another reason not listed previously.
  • “No valid products present”
    • The request body doesn’t contain bundle or mobile_line data in the products object.
  • “No se puede dar de alta mas de un tipo de producto (bundle, broadband, mobile line) en la misma request”
    • The request body contains more than one product
  • “Tarjeta no asociada al distribuidor”
    • The specified simcard was not associated to the dealer found in the request.
  • “No se ha podido bloquear el msisdn ”
    • The request is valid but the service was not able to lock the msisdn for the sell
  • “El tipo de documento %d no es correcto para una persona fisica del sector %d”
    • The document type NIF/DNI/TR/PASS is not a valid for the given sector
  • “El tipo de documento %d no es correcto para una persona juridica del sector %d”
    • The document type CIF is not valid is not valid for a business of the given sector
  • “Se requieren todos los campos de dirección de expedición”
    • All the fields in the expedition address are required
  • “Se requieren todos los campos de dirección de cliente del tipo "
    • All the fields in the customer’s address are required
  • “Tipo ‘client’ o ‘existing’ es obligatorio definirlo”
    • The client type, found in the field clients.attributes[].type is required
  • “Obligatorio iccid para un alta offline”
    • The iccid is required when the signup is offline, since simcards phisically in the store
  • “Obligatorio icc donante en caso de tipo de linea donante prepag”
    • For portabilities, a prepaid signup requires the doner icc
  • “Obligatoria scheduled_date para tipo de operacion programada”
    • For scheduled portabilities, the scheduled_date is required
  • “El " + getDocumentMessage(documentTypeId, documentValue) + " no es correcto”
    • The value or format of the given identification document is not valid. For example, the provided NIF doesn’t have 8 digits or the letter is wrong
  • “La fecha de nacimiento no es correcta”
    • The birth date is not valid or the customer is under legal age
  • “No es posible enviar la cuenta bancaria al añadir una linea a un contrato”
    • The bank account or the account number is not valid
  • “Estado del contrato no permite añadir suscripciones”
    • Subscriptions cannot be added due to the status of the account, which indicates it is not active
  • “La operacion no se puede realizar sobre un contrato convergente”
    • Cannot add new subscriptions to an account with an existing bundle

DuplicateRequestException

  • “Duplicate request still in process”
    • A request with the same payload is already being processed, this could be caused

UnexpectedException

  • “Could not retrieve existing user info with userInfoId %s and mobileOperatorId %s”
    • The request failed when the service attempted to find the user information using the “tree”

ResourceNotFoundException

  • “Error retrieving user info. Msisdn not found”
    • The request failed because the user could not be found using their msisdn and the service couldn’t validate whether they have an active subscription

SignupException

The service processed the request but the downstream backend returned an error

  • “Error en el proceso de venta paquetizada. MySim GlobalSell socket error. StatusCode:”
  • “MySim CloseOnlineSell socket error. StatusCode:”
  • “MySim CreateAccount socket error. StatusCode:”
  • “MySim CreateCustomer socket error. StatusCode:”
  • “MySim CreateSubscription socket error. StatusCode:”
  • “MySim CreateUser socket error. StatusCode:”
  • “Error en el proceso de venta paquetizada. MySim GlobalSell socket error. StatusCode:”
  • “MySim LockMsisdn socket error. StatusCode: "

SignupMysimException

  • “MySim CloseOnlineSell socket error. StatusCode:”
    • The service processed the request but the downstream backend returned an error
Glossary