POST /v3/agencias

Invita una Agencia a registrarse en Autocosmos. Se enviará un email a la dirección especifícada en la propiedad AdminMail. Quién lo reciba, deberá seguir la indicaciones para registrar su agencia en Autocosmos. Si tu App está suscripta a las notificaciones (endpoint AppNotificaciones), recibirás un webhook cuando el usuario se registre. Si no estas suscripto podrás consultar el estado de la invitación usando la Location, que te devolvimos en el header, con el HTTP-Method OPTIONS o GET.

Request

Body content

AgenciaCreate

Registración de una nueva agencia. Es posible crear una agencia sólo si el email del administrador de la cuenta es desconocido en Autocosmos. En caso contrario el propietario de la cuenta existente deberá autorizar la app.

Name	Type	Constraints	Descripción
AdminMail	string (email)	Min length 8 Max length 50	Email del operador administrador de la subscription en Autocosmos.
NombreComercial	string	Min length 3 Max length 100	Nombre comercial (visible al usuario final).
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.
Direccion	string	Min length 0 Max length 200	Dirección (calle + altura) de la sucursal principal locación de venta/servicio.
Telefono	string (tel)	Min length 8 Max length 20	Teléfono sucursal principal. Si se usa el formato '+{country-code}{zone-code}{number}' se intepreta como de tipo Whatsapp.
AdminNombre	string	Min length 0 Max length 50	Nombre del operador administrador de la suscription (friendly name para comunicación con posibles clientes).
AdminApellido	string	Min length 0 Max length 50	Apellido del operador administrador de la suscription.

AgenciaCreate Content-Type: application/json

{
  "AdminMail": "franco@superautos.com",
  "NombreComercial": "Super Autos",
  "Region": "IT-MO",
  "Ciudad": "Maranello",
  "Direccion": "Av. Siempreviva 742",
  "Telefono": "+xx 9xx 12345678",
  "AdminNombre": "Franco",
  "AdminApellido": "Ghigliermini"
}

Responses

HTTP-StatusCode 202

Invitación aceptada, se envió un e-mail a la dirección que será el administrador de la cuenta.

Headers

Name	Type	Descripción
Location	string (uri)	URI agencia.

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 409

El e-mail que nos proporcionaste ya está registrado en Autocosmos; el administrador deberá contactarse con nuestro SAC.

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": {}
}