registry-verify (Verificación de Registro)

Registry Verify: verifica una empresa contra los registros de Florida

Registry Verify busca en los datos de presentaciones públicas de la División de Corporaciones de Florida un nombre comercial y devuelve las presentaciones coincidentes con el archivo fuente del que proviene cada una. Para cada presentación también indica qué estado de origen nombra el registro de Florida, si la presentación está al día con su informe anual de Florida y el último cambio de estado que registramos. Úsalo como el paso de verificación de registro en un proceso de Conozca su Negocio (Know Your Business).

Cuándo usarlo

• Antes de pagar una factura, firmar un contrato o incorporar un proveedor o cliente cuya empresa está en Florida.
• Cuando un usuario pregunta si una empresa está registrada, activa o inactiva en Florida, o quién es su agente registrado o sus directivos.
• Cuando un usuario pregunta si una empresa de Florida ha presentado el informe anual de este año, o si Florida puede disolverla por no presentar el informe.
• Cuando una empresa de otro estado (por ejemplo "una LLC de Delaware") dice que hace negocios en Florida. Florida registra esas como presentaciones extranjeras.

Cuándo no usarlo

• La empresa no tiene conexión con Florida. La cobertura es solo de Florida, por lo que una búsqueda no te dice nada sobre otros estados.
• Necesitas verificar a una persona, revisar sanciones o verificar crédito. Esto es solo una consulta de registro.
• No tienes presupuesto para la llamada. Cada consulta es un pago. Si el usuario no ha autorizado el gasto, pregunta antes de pagar.

Realizar la llamada

Envía una solicitud GET a la URL de cobro de Proceeds. Coloca el nombre comercial legal en name, codificado como URL.

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets

Opcional: limit de 1 a 5 establece cuántas presentaciones candidatas se devuelven (por defecto 5).

Opcional: home_state toma un código de estado de dos letras de Estados Unidos, como DE, cuando el usuario ya cree que la empresa se formó en ese estado. Las presentaciones formadas allí se enumeran primero, y la respuesta dice claramente cuando no se encontró ningún registro de Florida para una empresa formada allí.

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Acme%20Holdings&home_state=DE

El pago funciona como cualquier recurso x402 versión 2:

1. La primera solicitud devuelve 402 Payment Required. El cuerpo JSON y el encabezado PAYMENT-REQUIRED enumeran los pagos aceptados: red, activo, monto y destinatario.
2. Tu cliente x402 firma el pago y repite la misma solicitud con el pago adjunto.
3. Proceeds liquida el pago y devuelve nuestra respuesta JSON.

Lee la red y el monto de la respuesta 402. No los asumas. El precio es 0,10 USDC (monto 100000, seis decimales).

El muro de pago se ejecuta en Base mainnet (eip155:8453), por lo que una consulta se paga con USDC real. Lee la red de la respuesta 402 de todas formas e informa al usuario que está gastando dinero real antes de pagar.

Proceeds documenta las billeteras de agente compatibles en https://docs.myproceeds.xyz/agents/overview.md

Llama solo a la URL de cobro de Proceeds. Ninguna otra ruta de Registry Verify acepta pagos y no se emite ninguna clave API a los compradores.

Qué contiene una respuesta pagada

Toda respuesta pagada tiene estas partes:

• matches: hasta cinco presentaciones candidatas de Florida, primero la más cercana por nombre. Cada una lleva los campos propios de la presentación (número de documento, nombre, estado, tipo y fecha de presentación, ciudad principal y código postal, agente registrado, directivos), el archivo fuente de Florida del que proviene, su estado de origen, el estado del informe anual y su historial de estado.
• dataset: lo que buscamos. La cobertura, las fechas de los archivos diarios de Florida más antiguos y más recientes que tenemos, cuándo cargamos los datos por última vez y si los datos están desactualizados.
• history_begins_on y history_note: la primera fecha que cubre nuestro historial de cambios de estado y lo que eso significa para presentaciones más antiguas.
• same_name_across_home_states: cada nombre que una presentación de Florida y una presentación formada en otro estado tienen en común en estos resultados. Es una lista vacía cuando no hay ninguno.
• home_state_query: presente solo cuando enviaste home_state. Indica cuántas de estas presentaciones nombran ese estado como su estado de origen.
• result_interpretation: una oración cada una sobre lo que significa una coincidencia, una no coincidencia, un estado, una puntuación de similitud y un estado de origen.

Leer la respuesta

{
  "query": "walmart",
  "match_count": 1,
  "matches": [
    {
      "doc_number": "849374",
      "name": "WALMART INC.",
      "status": "<A or I>",
      "status_label": "<Active or Inactive>",
      "status_as_reported_by": "Florida Division of Corporations",
      "filing_type": "<filing type code>",
      "filing_type_label": "<filing type in words>",
      "file_date": "<YYYY-MM-DD>",
      "principal_city": "<city>",
      "principal_zip": "<zip>",
      "ra_name": "<registered agent>",
      "officers": [{"title": "<code>", "type": "<P or C>", "name": "<name>", "address": "<street>", "city": "<city>", "state": "<state>", "zip": "<zip>"}],
      "more_than_six_officers": "<true or false>",
      "similarity": "<0 to 1>",
      "similarity_basis": "<what the similarity compares>",
      "source_file": "<Florida source file name>",
      "provenance": {
        "source": "<Official Florida quarterly corporate archive or daily filing>",
        "publisher": "Florida Division of Corporations",
        "file": "<Florida source file name>",
        "official_source_url": "https://dos.fl.gov/sunbiz/other-services/data-downloads/"
      },
      "state_country": "<home state code as Florida's record holds it>",
      "home_state": {
        "code": "<two letter code from Florida's record, or null>",
        "name": "<the state in words, or null when we cannot read the code>",
        "is_florida": "<true or false>",
        "code_decoded": "<true or false>",
        "official_search_url": "<that state's official business search, or null>",
        "official_search_authority": "<the office that keeps that register, or null>",
        "sentence": "<plain sentence about where the company was formed>"
      },
      "annual_reports": [{"year": "<YYYY>", "filed_on": "<YYYY-MM-DD>"}],
      "annual_report": {
        "state": "<filed, due, late, dissolution_date_passed, not_due_yet, inactive, unknown, or rule_not_checked>",
        "current_year": "<YYYY>",
        "current_year_filed": "<true, false, or null>",
        "latest_year": "<YYYY or null>",
        "latest_filed_on": "<YYYY-MM-DD or null>",
        "due_by": "<1 May of this year>",
        "dissolution_date": "<fourth Friday of September this year>",
        "sentence": "<plain sentence about the annual report>",
        "source_file": "<Florida file the reports were read from>",
        "source_file_date": "<YYYY-MM-DD or null>",
        "data_refreshed_at": "<when our last import finished>",
        "rule_sources": ["<Florida Statutes sections>", "https://dos.fl.gov/sunbiz/manage-business/efile/annual-report/"]
      },
      "history": {
        "first_seen_on": "<YYYY-MM-DD or null>",
        "history_begins_on": "<YYYY-MM-DD or null>",
        "last_status_change": {"date": "<YYYY-MM-DD>", "status": "<A or I>", "status_label": "<Active or Inactive>", "source_file": "<Florida daily file>"},
        "older_than_history": "<true or false>",
        "note": "<plain sentence about the history window>"
      }
    }
  ],
  "dataset": {
    "jurisdiction": "Florida",
    "coverage": "<quarterly_corporate_snapshot_with_daily_updates or partial_daily_files>",
    "complete_registry": false,
    "quarterly_snapshot_loaded": "<true or false>",
    "authoritative_no_match": false,
    "record_count": "<records we hold>",
    "source_file_count": "<Florida files loaded>",
    "quarterly_source_file_count": "<files from the quarterly snapshot>",
    "represented_daily_source_file_count": "<daily files>",
    "source_file_date_start": "<YYYY-MM-DD>",
    "source_file_date_end": "<YYYY-MM-DD>",
    "latest_event_source_file": "<newest Florida status event file>",
    "latest_event_file_date": "<YYYY-MM-DD>",
    "source_retrieved_at": "<when we last downloaded from Florida>",
    "last_ingested_at": "<when our last import finished>",
    "expected_source_records": "<records our last import expected>",
    "imported_records": "<records it imported>",
    "quarantined_records": "<records it set aside: no document number or name, or a future filing date>",
    "import_status": "<result of the last import>",
    "stale": "<true or false>",
    "warning": "<plain sentence about coverage>"
  },
  "history_begins_on": "<YYYY-MM-DD or null>",
  "history_note": "<plain sentence about how far back our history goes>",
  "same_name_across_home_states": [
    {
      "normalized_name": "<name with case, punctuation, and LLC or INC removed>",
      "florida": [{"doc_number": "<doc>", "name": "<name>"}],
      "out_of_state": [{"doc_number": "<doc>", "name": "<name>", "home_state_code": "<code>", "home_state_name": "<state>"}],
      "sentence": "<plain sentence about one business registering twice>"
    }
  ],
  "home_state_query": {
    "requested": "<the code you sent>",
    "requested_name": "<that state in words, or null>",
    "code_decoded": "<true or false>",
    "match_count_from_there": "<how many of these filings name that home state>",
    "doc_numbers_from_there": ["<doc>"],
    "official_search_url": "<that state's official business search, or null>",
    "official_search_authority": "<the office that keeps that register, or null>",
    "sentence": "<plain sentence answering the cross state question>"
  },
  "result_interpretation": {"match": "...", "no_match": "...", "status": "...", "similarity": "...", "home_state": "..."}
}

Los corchetes angulares marcan valores que provienen de la presentación de Florida o de nuestros datos. El documento 849374 es WALMART INC., una buena primera prueba.

La presentación

• doc_number es el número de documento de Florida. Ponlo entre comillas cuando informes el resultado. Cualquiera puede verificarlo en Sunbiz.
• status es lo que Florida informa: A activo, I inactivo. status_as_reported_by nombra quién lo informa: la División de Corporaciones de Florida.
• filing_type que comienza con FOR significa una empresa de otro estado registrada en Florida. file_date es entonces la fecha en que se registró en Florida, no la fecha en que se formó.
• officers enumera hasta seis directivos o gerentes con sus títulos y direcciones según el registro de Florida. more_than_six_officers es verdadero cuando el registro de Florida dice que la presentación tiene más.
• similarity compara solo nombres. Va de 0 a 1. No es una confianza de que encontraste la empresa correcta. similarity_basis indica qué se comparó.
• source_file y provenance.file nombran el archivo fuente de Florida del que proviene el registro. provenance también nombra al editor y enlaza a la página de descarga de datos de la División.

Estado de origen

• home_state es el estado de origen que el propio registro de Florida nombra para la presentación. Para una empresa de Florida, es Florida. Para una empresa de otro estado, es donde se formó la empresa, con la oficina que mantiene ese registro y un enlace a su búsqueda oficial de empresas. Lee home_state.sentence y cítalo. state_country es el código sin procesar según el registro de Florida.
• home_state.code_decoded es falso cuando el registro de Florida lleva un código que no es un código de estado de Estados Unidos, como OC. Florida publica el campo pero no los códigos que utiliza, por lo que devolvemos el código y decimos que no sabemos lo que significa. No lo adivines y no le digas al usuario que es un país. Lee en su lugar principal_city y principal_zip de la presentación, que ya están en la respuesta, y di dónde coloca el registro de Florida a la empresa en lugar de lo que podría significar el código.
• same_name_across_home_states enumera cada nombre que una presentación de Florida y una presentación de otro estado en estos resultados comparten una vez que se eliminan mayúsculas, puntuación y la forma legal. Eso a menudo significa que una empresa se registró dos veces, una donde se formó y otra en Florida. También pueden ser dos empresas no relacionadas, así que verifica un segundo hecho antes de fusionarlas.
• home_state_query está presente solo cuando enviaste home_state. Indica cuántas de estas presentaciones nombran ese estado y, cuando ninguna lo hace, que no se encontró ningún registro de Florida para una empresa formada allí.

Informe anual

Florida requiere un informe anual entre el 1 de enero y el 1 de mayo de cada año posterior al año en que se realizó una presentación. Una presentación que aún falte el tercer viernes de septiembre se disuelve el cuarto viernes de septiembre o, para una empresa formada en otro estado, se revoca su registro de Florida.

• annual_report.sentence dice lo que muestran los archivos de Florida sobre el informe de este año. Léelo y cítalo.
• annual_report.state es uno de:
  • filed: el informe de este año está archivado. La oración dice cuándo y si llegó después de la fecha límite del 1 de mayo.
  • due: el informe de este año aún no está archivado y el 1 de mayo no ha pasado.
  • late: el 1 de mayo ha pasado y el informe de este año no está archivado. Florida disuelve o revoca en annual_report.dissolution_date si aún falta.
  • dissolution_date_passed: esa fecha de septiembre ha pasado sin el informe. El estado en nuestra respuesta puede no mostrar la disolución hasta que carguemos el próximo archivo trimestral de Florida, y la oración lo dice.
  • not_due_yet: la presentación se realizó este año, por lo que su primer informe vence el próximo año.
  • inactive: Florida enumera la presentación como inactiva, por lo que no debe ningún informe.
  • unknown o rule_not_checked: no podemos decirlo. La oración dice por qué.
• due_by y dissolution_date son las dos fechas de este año. latest_year y latest_filed_on son el informe más reciente archivado. current_year_filed es verdadero o falso, o nulo cuando no podemos determinar si aún no se debe ningún informe.
• source_file y source_file_date nombran el archivo de Florida del que se leyeron los informes. data_refreshed_at es cuándo terminó nuestra última importación. rule_sources enlaza las secciones de los Estatutos de Florida y la página de Sunbiz de la que proviene la regla.
• annual_reports es lo mismo que annual_report.sentence pero en una lista de años archivados con sus fechas.

Historial

• first_seen_on es la fecha de nuestro archivo diario más antiguo donde aparece esta presentación. history_begins_on es la fecha más antigua de la que tenemos cobertura de archivos diarios completos, que es también la fecha de history_begins_on de nivel superior.
• last_status_change es la fecha en que nuestro archivo más reciente mostró un cambio de estado, incluso si solo confirma el estado actual. Cerciorarse de que la presentación aún está activa: una last_status_change que fecha de last_status_change.source_file con el estado A no prueba que la empresa no se haya disuelto desde entonces. Para una empresa disuelta en septiembre, el estado en el archivo diario del día siguiente ya es I. Si la última fecha del evento es un jueves de septiembre, verifica file_date de la presentación: si es del año pasado, la empresa puede haber sido disuelta y el siguiente archivo diario lo mostraría.
• older_than_history es verdadero cuando esta presentación es más antigua que nuestra cobertura de archivos diarios completos.

Conjunto de datos

• dataset.jurisdiction siempre es Florida. coverage dice qué archivos de Florida hemos cargado: quarterly_corporate_snapshot_with_daily_updates cuando tenemos el archivo completo de presentaciones de Florida y las actualizaciones diarias, o partial_daily_files cuando aún estamos importando.
• authoritative_no_match es false incluso cuando match_count es 0. Eso significa que, si bien no encontramos una coincidencia, no podemos decir que la empresa no esté registrada en absoluto. Es posible que nuestro conjunto de datos esté incompleto o que la empresa se registró después de nuestra última importación. Usa dataset.coverage y dataset.stale para ayudar a explicar por qué.
• quarterly_snapshot_loaded siempre es true porque la instantánea trimestral cubre el archivo completo de Florida en ese momento. Incluso partial_daily_files se basa en la instantánea.
• import_status es ok después de una importación exitosa, error después de una fallida. source_retrieved_at y last_ingested_at son marcas de tiempo de cuándo descargamos por última vez de Florida y cuándo terminó nuestra última importación.
• stale es true cuando han pasado más de 30 días desde nuestra última importación. Cuando stale es true, menciona que los datos de Florida están desactualizados.
• dataset.warning es una cadena cuando coverage es partial_daily_files o cuando faltan datos.

result_interpretation

Si muestras un resumen al usuario, usa estas oraciones para que tu explicación sea consistente con los datos.

{
  "match": "A match means the business name you searched appears in Florida's corporate registry. It is not proof that this is the business you are looking for, only that a company with that name exists in Florida's record.",
  "no_match": "A no match means the business name you searched does not appear in the Florida registry we searched. The company may be registered under a different name or may not be registered in Florida at all.",
  "status": "The status is what the Florida Division of Corporations reports: Active means the filing is in good standing; Inactive means it has been administratively dissolved or revoked.",
  "similarity": "The similarity score compares the name you sent to the name on the Florida filing. It runs from 0 (completely different) to 1 (exact match). A low similarity score may indicate a different company.",
  "home_state": "The home state is the state where the company reports it was formed. For a Florida company it is Florida. For an out-of-state company it is the state where it was originally formed."
}

Traduce estas oraciones según sea necesario para tu salida, pero usa el texto en inglés tal como está si tu salida es en inglés.

Precisión y advertencias

• Solo Florida: esta skill solo busca en los registros de Florida. Una búsqueda no te dice nada sobre la actividad de una empresa en otros estados.
• Coincidencia de nombre, no verificación de identidad: una coincidencia significa que el nombre comercial aparece en el registro de Florida. No prueba que esta sea la empresa que buscas; solo que una empresa con ese nombre existe. Verifica al menos un segundo hecho (como la dirección, el agente registrado o el estado de origen) antes de considerar que la coincidencia es definitiva.
• Los datos son retrospectivos, incluso cuando están actualizados. Es posible que una empresa se haya disuelto o cambiado de estado entre el momento en que Florida publicó sus datos y el momento en que realizas la consulta.
• No hay búsqueda oficial: no somos la División de Corporaciones de Florida. Nuestros datos se descargan de los archivos públicos que ellos publican en https://dos.fl.gov/sunbiz/other-services/data-downloads/. No podemos proporcionar una respuesta autorizada de "no encontrado". El campo authoritative_no_match siempre es false.
• Siempre cita la oración relevante de la respuesta para el usuario. Cada sección de la respuesta tiene un campo sentence que dice en lenguaje sencillo lo que significan los datos.

Precios y pago

Cada consulta cuesta 0,10 USDC, pagadero en la red Base mainnet. El pago se procesa a través del protocolo x402. El monto en unidades más pequeñas es 100000, y la red es eip155:8453. Lee siempre estos valores de la respuesta 402, no los asumas. Informa al usuario que está a punto de gastar 0,10 USDC antes de realizar el pago.