{
  "openapi": "3.1.0",
  "info": {
    "title": "HF Imports — estimación Iquique a Santiago",
    "version": "1.0.0",
    "description": "Estimación comercial con los parámetros vigentes de la tienda HF para Santiago. No verifica elegibilidad, no otorga franquicias ni autoriza circulación. Si has_franchise es false devuelve franchise_required sin total. Los tributos efectivos dependen de la franquicia y la operación; no confundir la estimación con una liquidación tributaria. No modifica inventario ni guarda cotizaciones."
  },
  "servers": [
    {
      "url": "https://www.hf-imports.com"
    }
  ],
  "paths": {
    "/blog/herramientas/precio-zona-franca/calcular.php": {
      "post": {
        "operationId": "hf_estimate_zona_franca_santiago",
        "summary": "Estimar costos comerciales condicionados a franquicia",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "iquique_clp": {
                    "type": "integer",
                    "minimum": 10000,
                    "maximum": 2000000000,
                    "description": "Precio total en Iquique en CLP. No es el FOB en dólares."
                  },
                  "has_franchise": {
                    "type": "boolean",
                    "description": "Declaración explícita del usuario de que cuenta con una franquicia aplicable; no inferir ni tratar como verificación."
                  }
                },
                "required": [
                  "iquique_clp",
                  "has_franchise"
                ],
                "additionalProperties": false
              },
              "examples": {
                "conFranquicia": {
                  "value": {
                    "iquique_clp": 25400000,
                    "has_franchise": true
                  }
                },
                "sinFranquicia": {
                  "value": {
                    "iquique_clp": 25400000,
                    "has_franchise": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Estimación condicionada; eligibility_verified siempre false",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "total_clp",
                    "breakdown_clp",
                    "conditions",
                    "eligibility_verified",
                    "source_url"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "total_clp": {
                      "type": "number"
                    },
                    "additional_clp": {
                      "type": "number"
                    },
                    "breakdown_clp": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "number"
                      }
                    },
                    "eligibility_verified": {
                      "const": false
                    },
                    "franchise_status": {
                      "const": "declared_by_user_not_verified"
                    },
                    "conditions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "source_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Entrada inválida o franchise_required: sin total"
          },
          "400": {
            "description": "Objeto JSON inválido"
          },
          "405": {
            "description": "Solo POST u OPTIONS"
          },
          "413": {
            "description": "Máximo 4096 bytes"
          },
          "415": {
            "description": "Requiere application/json"
          },
          "503": {
            "description": "Parámetros de tienda no disponibles; sin valores inventados"
          }
        }
      }
    }
  }
}