Saltar al contenido principal

Points of Sale

The EMIZOR API allows you to obtain the list of points of sale that have been registered in the EMIZOR system.

To obtain this list, the points of sale must first be registered in the EMIZOR system. This process can be done through the EMIZOR administration platform, or through the API.

Creating a new Point of Sale​

There is a service available to create a new point of sale in the EMIZOR system. To consume this service, refer to the following link in the documentation:

POST/api/v1/sucursales/{branchCode}/puntos-de-ventaCreates a new point of sale.

Where:

  • branchCode: is the branch code.

The request body includes:

{
  "nombre": "string",
  "descripcion": "string",
  "tipo": 0
}

Where:

  • nombre is the name that the point of sale will have.
  • descripcion is the description that the point of sale will have.
  • tipo is the code of the type of point of sale, as shown in the list of Point of Sale Types in the parameters.

Successful response: code 200

{
  "status": "string",
  "data": {
    "codigo": 0,
    "nombre": "string",
    "descripcion": "string",
    "tipo": {
      "codigo": 0,
      "descripcion": "string"
    },
    "codigoSucursal": 0
  }
}

Where:

  • codigo is the code of the point of sale.
  • nombre is the name of the point of sale.
  • descripcion is the description of the point of sale.
  • tipo is the detail of the type of point of sale assigned to the point of sale, with its corresponding code and description.
  • codigoSucursal is the code of the branch to which the point of sale belongs.

Obtaining the List of Points of Sale​

There is a service available to obtain the list of points of sale. To consume this service, refer to the following link in the documentation:

GET/api/v1/puntos-de-ventaReturns the list of points of sale.

Successful response: code 200

{
  "status": "string",
  "data": [
    {
      "codigo": "string",
      "nombre": 0,
      "descripcion": 0,
      "tipo": {
        "codigo": 0,
        "descripcion": "string"
      }
    }
  ]
}

Where:

  • data is the list of points of sale.
  • codigo is the code of each point of sale.
  • nombre is the name of each point of sale.
  • descripcion is the description of each point of sale.
  • tipo is the detail of the type of point of sale assigned to each point of sale, with its corresponding code and description.

Cancellation of a Point of Sale​

In addition to the previous ones, there is also a service available to cancel a point of sale. To consume this service, refer to the following link in the documentation:

DELETE/api/v1/sucursales/{branchCode}/puntos-de-venta/{posCode}Cancels a point of sale.

Where:

  • branchCode: The branch code.
  • posCode: The point of sale code.

Successful response: code 200

{
  "status": "string",
  "data": {
    "codigoPuntoVenta": "string"
  }
}

Where:

  • codigoPuntoVenta is the code of the cancelled point of sale.