Saltar al contenido principal

Create simplified address

POST 
/company/address/simple

Crea una nueva dirección de manera simplificada usando únicamente coordenadas y datos básicos. Este endpoint está optimizado para casos donde se conocen las coordenadas exactas y se necesita crear una dirección rápidamente sin la complejidad de los datos de Google Maps.

Flujo de operación:

  1. Autenticación mediante JWT válido
  2. Validación de campos mínimos obligatorios (lat, lng, name, company_name)
  3. Geocodificación inversa automática desde coordenadas
  4. Creación automática de dirección completa
  5. Asociación a la compañía del usuario
  6. Retorno de la dirección creada

Ventajas de este endpoint:

  • Requiere solo 4 campos obligatorios vs ~15 del endpoint estándar
  • Geocodificación automática desde coordenadas
  • Reutiliza la lógica probada del sistema de importación masiva
  • Mantiene la misma calidad de datos que la creación normal

Casos de uso típicos:

  • Aplicaciones móviles con GPS
  • Integración desde sistemas de terceros con coordenadas
  • Creación rápida desde mapas interactivos
  • Bulk creation simplificado

Ejemplo de solicitud:

POST /company/address/simple
Authorization: Bearer {token}
Content-Type: application/json

{
  "lat": 40.416775,
  "lng": -3.703790,
  "name": "Oficina Central",
  "company_name": "CargoOffer SL",
  "phone": "+34912345678",
  "isDefault": false
}

Ejemplo de respuesta exitosa:

{
  "_id": "507f1f77bcf86cd799439011",
  "name": "Oficina Central",
  "company_name": "CargoOffer SL",
  "phone": "+34912345678",
  "street": "Calle de Alcalá, 42",
  "city": "madrid",
  "zipcode": "28014",
  "country": "es",
  "location": {
    "type": "Point",
    "coordinates": [-3.703790, 40.416775]
  },
  "is_default": false,
  "can_be_deleted": true
}

Request​

Responses​

Dirección creada exitosamente

Response Headers