POST /v3/publicaciones/{adminmail}

Crea una publicación de auto.

Request

Path parameters

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

Body content

PublicacionCreate

Creación de una publicación. Para Marca, Modelo, Version, Propulsion, Transmision, Carroceria, Region, Ciudad, Moneda etc. siempre nos ocuparemos de usar los algoritmos de 'best-match'; es decir que no es estrictamente necesario que tú lo hagas para cada valor. El único 'best-match' que tiene sentido que uses antes de crear una publicación es '/versiones/bestmatch' ya que te permite obtener valores usables en la creación de la publicación buscando por informaciones técnicas del auto hasta sin tener el nombre de la versión (aka sin 'trim').

Name	Type	Constraints	Descripción
ExternalId	string	Min length 2 Max length 255	ID que tu app asignó. CaseInsesitive, admite solo carácteres compatibles con valores admitidos en un path-segment de una URL (https://www.w3.org/Addressing/URL/5_URI_BNF.html) excluyendo algún otro carácter que nos resultan "poco sano".
RefStock	string	Min length 0 Max length 25	Identificación del auto en tu stock (matricula, chasis etc.)
Activa	boolean		Estado de la publicación (true = activa, false = suspendida, default= true).
Exposicion	string	Min length 0 Max length 5	Nivel de exposición (valores admitidos: Alta, Media, Baja) Si se deja en ```null```, o lo que enviste ya no está disponible, usaremos la mejor permitida/disponible.
OperadorResponsable	string (email)	Min length 0 Max length 50	Colaborador responsable de la publicación. Se usará el colaborador administrador de la agencia si el valor es null.
Marca	string	Min length 1	Marca (aka 'make') Soportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch)
Modelo	string	Min length 1	Modelo del auto (aka 'model') Soportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch)
Version	string	Min length 0 Max length 50	Versión del auto (aka 'trim') Soportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch) Para determinar Marca+Modelo conocidas por Autocosmos, en el caso proveas un texto desconocido a Autocosmos, usaremos el best-match pero solo con la información disponible en la creación de la publicación (ver Versiones 'rel' = bestmatch). Si no es posible establecer exactamente una versión conocida por Autocosmos, respecteremos el nombre de la versión que proporcionaste. Si quieres aprovechar nuestra información técnica, y evitar un mapeo de información de tu lado, es aconsejable que uses la información del response del best-match (ver Versiones rel = bestmatch).
VersionYear	integer (int32)	Min value 1908 Max value 2050	Año de la versión o año de matriculación del auto.
Transmision	string		Tipo de trasmisión Transmision ('Automática', 'Manual', 'A', 'M').
Propulsion	string		Combustible (aka 'FuelType') Soportado id, api-url, api-url-path, nombre completo, codename (ver Propulsiones 'rel' = bestmatch).
Carroceria	string		Carrocería (aka 'Body-Style') Soportado id, api-url, api-url-path, nombre completo, codename (ver Carrocerias 'rel' = bestmatch)
Kilometraje	integer (int32)	Min value 0 Max value 999000	Kilometraje del auto. 0 solo para autos nuevos (no matriculados). Para autos usados o seminuevos usar el kilometraje real del auto. Algunos valores sospechosos o no admitidos en los productos contractados por la agencia, pueden provocar el rechazo de la publicación.
Color	string	Min length 1	Color del auto (truncated at 50 characters).
Descripcion	string	Min length 0 Max length 2000	Descripción de la operación de venta, comentarios sobre el auto etc.
DatosTecnicosCustom	`array` of	Max items 50	Equipamiento custom (para versiones desconocidas en Autocosmos). Si creando la publicación usas un nombre de V3.Models.Version, desconocido en Autocosmos, podrás agregar información del equipamiento y ficha tecnica. Si creando la publicación usas una referencia a una V3.Models.Version conocida en Autocosmos, usaremos nuestra información de equipamiento y ficha tecnica detallada.
Precio	V3.Models.Valor
Adelanto	V3.Models.Valor
Cuota	V3.Models.Valor
Fotos	`array` of		URLs públicamente accesibles, de las imágenes (haremos un download de la fotos desde estas URLs). La lista de fotos se debe completar obligatoriamente para publicación de usados. Haremos un download de la fotos desde estas URLs. Constraints: min-width=640px;min-height=360px.
AplicaCertificadoGarantiaUsado	boolean		Certificado de garantía expuesto en la publicación.
Locacion	V3.Models.Publicacion_DireccionVenta
Telefono	string		Teléfono para la venta del auto. null = se usa uno de los telefonos actuales del operador responsable de la publicación NOTA : normalmente se deja en null

PublicacionCreate Content-Type: application/json

{
  "ExternalId": "ACD12345",
  "RefStock": "x879",
  "Activa": true,
  "Exposicion": null,
  "OperadorResponsable": null,
  "Marca": "BMW",
  "Modelo": "Serie 3",
  "Version": "330I SEDAN SPORT LINE",
  "VersionYear": 2016,
  "Transmision": "Manual",
  "Propulsion": "gasolina",
  "Carroceria": "Sedan",
  "Kilometraje": 112000,
  "Color": "Azul",
  "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.",
  "DatosTecnicosCustom": [
    "cierre centralizado",
    "levanta vidrios electricos"
  ],
  "Precio": {
    "Moneda": "USD",
    "Importe": 29500
  },
  "Adelanto": null,
  "Cuota": null,
  "Fotos": [
    "https://tu_public_domain/somefolder/foto1.jpg",
    "https://tu_public_domain/somefolder/foto2.jpg"
  ],
  "AplicaCertificadoGarantiaUsado": false,
  "Locacion": null,
  "Telefono": null
}

Responses

HTTP-StatusCode 201

Created

Headers

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

Publicacion when Accept: application/json application/vnd.autocosmos.entry+json text/json

{
  "ExternalId": "ACD12345",
  "RefStock": "x879",
  "EstadoActual": "Activa",
  "Exposicion": "Baja",
  "OperadorResponsable": "franco@superautos.com",
  "Marca": "BMW",
  "Modelo": "Serie 3",
  "Version": "330I SEDAN SPORT LINE",
  "VersionYear": 2016,
  "Transmision": "Manual",
  "Propulsion": "gasolina",
  "Kilometraje": 112000,
  "Color": "Azul",
  "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.",
  "DatosTecnicosCustom": [],
  "Precio": {
    "Moneda": "USD",
    "Importe": 29500
  },
  "Adelanto": null,
  "Cuota": null,
  "Fotos": [
    "https://somedomain/somefolder/foto1.jpg",
    "https://somedomain/somefolder/foto2.jpg"
  ],
  "CertificadoDeGarantiaUsado": null,
  "Locacion": {
    "Region": "Modena",
    "Ciudad": "Maranello",
    "Direccion": "Av. Siempreviva 742"
  },
  "Telefono": "+xx 9xx 12345678",
  "Consultas": {
    "_links": {
      "rel1": {
        "href": "/v3/consultas/somevalue"
      },
      "rel2": {
        "href": "/v3/consultas/somevalue?param1={param1}&param2={param2}",
        "templated": true
      }
    }
  },
  "_links": {
    "rel1": {
      "href": "/v3/publicaciones/somevalue"
    },
    "rel2": {
      "href": "/v3/publicaciones/somevalue",
      "method": "PUT"
    }
  }
}

PublicacionRef when Accept: application/vnd.autocosmos.ref+json

{
  "etag": "uDUbRssKWk2r70O5FM7+xvzVGGXBiNkI",
  "ExternalId": "ACD12345",
  "EstadoActual": "Activa",
  "href": "/v3/publicaciones/franco@superautos.com/ACD12345",
  "title": "BMW Serie 3 330I SEDAN SPORT LINE (2016)"
}

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

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

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