Peru — utang · lookupCoactiva

May utang sa tax enforcement (Peru)

GET https://api.latinfo.dev/pe/sunat/coactiva/ruc/{ruc}

Inilathalang obserbasyon ng utang na naka-grupo ayon sa taxpayer na legal na entidad. Saklaw: Mga RUC ng legal na entidad sa inilathalang listahan ng utang na nasa sapilitang koleksiyon. Maghanap gamit ang ruc bilang string at panatilihin ang mga unang zero. Tinutukoy ng kontrata sa ibaba ang tinatanggap na syntax at normalization. Mga rounded integer sa PEN ang halaga; hindi sertipiko ng pagsunod sa buwis ang kawalan ng nakalistang utang. Nagbabalik ng isang record. Hindi petsa ng obserbasyon ang oras ng import; suriin ang mga freshness header.

Kontrata ng source

Tagapaglathala: SUNAT, Peru
Saklaw: Mga RUC ng legal na entidad sa inilathalang listahan ng utang na nasa sapilitang koleksiyon.
Kahulugan ng tala: Inilathalang obserbasyon ng utang na naka-grupo ayon sa taxpayer na legal na entidad.
Pantukoy: Maghanap gamit ang ruc bilang string at panatilihin ang mga unang zero. Tinutukoy ng kontrata sa ibaba ang tinatanggap na syntax at normalization.
Tinatanggap na pattern: ^\d{11}$
Bilang ng mga tala: one
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

Mga rounded integer sa PEN ang halaga; hindi sertipiko ng pagsunod sa buwis ang kawalan ng nakalistang utang.

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

rucstringPathkailangan

Maghanap gamit ang ruc bilang string at panatilihin ang mga unang zero. Tinutukoy ng kontrata sa ibaba ang tinatanggap na syntax at normalization.

Example: 20348858182

Halimbawa ng request

curl https://api.latinfo.dev/pe/sunat/coactiva/ruc/20348858182 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Mga tugon

200Mga inilathalang source record. Hindi patunay ng clearance o negatibong natuklasan ang nawawalang datos.

Mga header ng tugon

X-Latinfo-Imported-At

Oras ng import, hindi petsa ng obserbasyon ng pamahalaan.

X-Source-Updated-At

Oras ng pag-update ng pinagmulan, kung alam.

X-Latest-Observation-At

Pinakahuling petsa ng obserbasyon sa pahinang ito, kung alam. Para sa buong paginated history, panatilihin ang petsa ng bawat pahina o kunin ang pinakamataas sa lahat. Huwag gamitin ang oras ng import bilang petsa ng obserbasyon.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN

X-Credits-Cost

Aktuwal na credits na siningil para sa request na ito.

X-Source-Generation

Opaque at immutable na source generation. Sundan ang guarded next-page Link kapag kinukuha ang history.

Content-Type: application/json

Mga field ng tugon

ruc string kailangan

Maghanap gamit ang ruc bilang string at panatilihin ang mga unang zero. Tinutukoy ng kontrata sa ibaba ang tinatanggap na syntax at normalization.

name string kailangan

Inilathalang pangalan ng entidad.

commercial_name string kailangan

Inilathalang trade name; maaaring wala.

dependency string kailangan

Tanggapan ng SUNAT na responsable sa inilathalang kaso ng koleksiyon.

amount string kailangan

Inilathalang halaga ng utang na nasa sapilitang koleksiyon, rounded integer sa PEN. Yunit: PEN.

PEN

rep_count string kailangan

Inilathalang bilang ng legal na kinatawan; nangangahulugang unavailable ang Sin información. Yunit: mga kinatawan.

representatives

Iskema ng tugon

{
  "type": "object",
  "properties": {
    "ruc": {
      "type": "string",
      "description": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "name": {
      "type": "string",
      "description": "Published entity name.",
      "x-latinfo-meaning": "text"
    },
    "commercial_name": {
      "type": "string",
      "description": "Published trade name; may be absent.",
      "x-latinfo-meaning": "text"
    },
    "dependency": {
      "type": "string",
      "description": "SUNAT office responsible for the published collection case.",
      "x-latinfo-meaning": "text"
    },
    "amount": {
      "type": "string",
      "description": "Published enforceable debt amount, rounded to integer PEN. Unit: PEN.",
      "x-latinfo-meaning": "amount",
      "x-latinfo-unit": "PEN"
    },
    "rep_count": {
      "type": "string",
      "description": "Published number of legal representatives; Sin información means unavailable. Unit: representatives.",
      "x-latinfo-meaning": "quantity",
      "x-latinfo-unit": "representatives"
    }
  },
  "required": [
    "ruc",
    "name",
    "commercial_name",
    "dependency",
    "amount",
    "rep_count"
  ],
  "additionalProperties": false
}

400Di-wastong identifier o query. Itama ang input bago subukang muli.