POST /v3/sucursales/{adminmail}

Crea una nueva Sucursal

Request

Path parameters

Name Type Constraints Descripción
adminMail string (email) Required
Email operador administrador de la agencia

Body content

Sucursal

Sucursal de una agencia habilitada a venta o servicio.

Name Type Constraints Example Descripción
Descripcion string "Sede central" Descripción de la sucursal
Email string (email) Min length 0
Max length 50
"sac@agencia.com" E-mail publico de la sucursal.
Telefono string (tel) Min length 0
Max length 50
Teléfono de atención al público.
Region string Min length 0
Max length 200
Provincia/Estado/Región de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre, iso.
Ciudad string Min length 0
Max length 200
Ciudad de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre completo, parte del nombre. (ver /v3/ciudades/bestmatch)
Direccion string Min length 0
Max length 200
"Av. Siempreviva 742" Dirección (calle + altura) de la sucursal.
Comercial boolean La sucursal da servicio de compra/venta.
TallerMecanico boolean La sucursal da servicio de taller.
Autopartes boolean La sucursal vende autopartes.
Laborable V3.Models.Sucursal_HorarioPublico
PreFestivo V3.Models.Sucursal_HorarioPublico
Festivo V3.Models.Sucursal_HorarioPublico
ResponsableLeadsPostVenta string (email) Min length 0
Max length 50
"postventa@agencia.com" E-mail responsable leads de post-venta. Debe ser un e-mail de un operador habilitado a operar con la agencia. Será ignorado en el caso la agencia no esté habilitada a recibir leads de post-venta.
_links object URIs de las acciones disponibles en la entidad. Cada propiedad representa la relación/acción con la entidad.
Sucursal Content-Type: application/json
{
  "Descripcion": "Sede central",
  "Email": "sac@agencia.com",
  "Telefono": "+xx 9xx 67895432",
  "Region": "IT-MO",
  "Ciudad": "/v3/ciudades/1234",
  "Direccion": "Av. Siempreviva 742",
  "Comercial": true,
  "TallerMecanico": false,
  "Autopartes": false,
  "Laborable": {
    "Desde": "08:00:00",
    "Hasta": "19:00:00"
  },
  "PreFestivo": {
    "Desde": "09:00:00",
    "Hasta": "14:00:00"
  },
  "Festivo": null,
  "ResponsableLeadsPostVenta": null,
  "_links": {
    "rel1": {
      "href": "/v3/sucursales/somevalue"
    },
    "rel2": {
      "href": "/v3/sucursales/somevalue",
      "method": "PUT"
    }
  }
}

Responses

HTTP-StatusCode 201

Created

Headers
Name Type Descripción
Location string (uri) URI sucursal.
Sucursal when Accept: application/json application/vnd.autocosmos.entry+json text/json
{
  "Descripcion": "Sede central",
  "Email": "sac@agencia.com",
  "Telefono": "+xx 9xx 67895432",
  "Region": "IT-MO",
  "Ciudad": "/v3/ciudades/1234",
  "Direccion": "Av. Siempreviva 742",
  "Comercial": true,
  "TallerMecanico": false,
  "Autopartes": false,
  "Laborable": {
    "Desde": "08:00:00",
    "Hasta": "19:00:00"
  },
  "PreFestivo": {
    "Desde": "09:00:00",
    "Hasta": "14:00:00"
  },
  "Festivo": null,
  "ResponsableLeadsPostVenta": null,
  "_links": {
    "rel1": {
      "href": "/v3/sucursales/somevalue"
    },
    "rel2": {
      "href": "/v3/sucursales/somevalue",
      "method": "PUT"
    }
  }
}
SucursalRef when Accept: application/vnd.autocosmos.ref+json
{
  "href": "/v3/sucursales/somevalue",
  "title": "Sede central (Av. Siempreviva 742, Maranello, Modena)"
}

HTTP-StatusCode 400

ValidationProblemDetails Content-Type: application/problem+json
{
  "Errors": {
    "_": [
      "entry problem1",
      "entry problem2"
    ],
    "property1": [
      "problem 1"
    ]
  },
  "Type": "https://httpstatuses.com/400",
  "Title": "Validación de información esperada fallida",
  "Status": 400,
  "Detail": "Alguna información contiene valores no validos.",
  "Instance": "/v3/somewhere",
  "Extensions": {}
}

HTTP-StatusCode 403

La agencia, para tu app, no existe.

ProblemDetails Content-Type: application/problem+json
{
  "Type": "https://httpstatuses.com/403",
  "Title": "Titulo de problema",
  "Status": 403,
  "Detail": "Alguna descripción del problema",
  "Instance": "/v3/somewhere",
  "Extensions": {}
}

HTTP-StatusCode 409

Existe ya una sucursal con la misma información.

ValidationProblemDetails Content-Type: application/problem+json
{
  "Errors": {
    "_": [
      "entry problem1",
      "entry problem2"
    ],
    "property1": [
      "problem 1"
    ]
  },
  "Type": "https://httpstatuses.com/400",
  "Title": "Validación de información esperada fallida",
  "Status": 400,
  "Detail": "Alguna información contiene valores no validos.",
  "Instance": "/v3/somewhere",
  "Extensions": {}
}