Lookup sunat · aduanet by RUC

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

One goods series of an import/export declaration; a company can have many records. Coverage: Legal-entity declarations in the imported weekly official customs files. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. FOB is USD and net weight is kg. Do not sum repeated declarations without series/file deduplication. Returns all records as an array. Import time is not observation time; inspect freshness headers. Add limit (1–500) and offset to retrieve an explicit page; without them the complete original array is returned. X-Total-Count gives the exact row count; follow Link rel=next to retrieve all pages.

Kontrata ng source

Publisher: SUNAT / ADUANET, Peru
Saklaw: Legal-entity declarations in the imported weekly official customs files.
Kahulugan ng tala: One goods series of an import/export declaration; a company can have many records.
Identifier: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern: ^20\d{9}$
Bilang ng mga tala: many
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

FOB is USD and net weight is kg. Do not sum repeated declarations without series/file deduplication.

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

RUC in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 20509208361

limitintegerquery

Optional page size. Supplying limit or offset enables explicit pagination; default page size is 100.

offsetintegerquery

Row offset, default 0. Keep the same source generation while collecting pages.

generationstringquery

Opaque source-generation guard, automatically included in the next-page Link. A changed generation returns 409; restart retrieval.

Halimbawa ng request

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

Mga tugon

200Published source records. Missing data is not a clearance or a negative finding.

Mga header ng tugon

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN

X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

Content-Type: application/json

Mga field ng tugon

[].ruc string kailangan

Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

[].operation_type string kailangan

import for MA/MAM formats; export for X formats.

[].declaration string kailangan

Composite customs-office/year/declaration identifier.

[].customs_office string kailangan

ADUANET customs office code.

[].declaration_year string kailangan

Declaration year.

[].declaration_number string kailangan

Declaration number; retain leading zeros.

[].declaration_date string kailangan

Published declaration date date. Format: YYYYMMDD.

[].operation_date string kailangan

Published operation date date. Format: YYYYMMDD.

[].series string kailangan

Goods series within a declaration; not a distinct company.

[].hs_code string kailangan

Ten-digit national tariff/NANDINA code.

[].description string kailangan

Published description.

[].country string kailangan

Origin country for imports; destination country for exports.

[].fob_usd string kailangan

Published FOB value; no currency conversion is applied. Unit: USD.

USD

[].net_weight_kg string kailangan

Published net goods weight. Unit: kg.

kg

[].source_file string kailangan

Original upstream weekly ZIP name for lineage.

Response schema

{
  "type": "array",
  "items": {
    "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."
      },
      "operation_type": {
        "type": "string",
        "description": "import for MA/MAM formats; export for X formats.",
        "x-latinfo-meaning": "text"
      },
      "declaration": {
        "type": "string",
        "description": "Composite customs-office/year/declaration identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "customs_office": {
        "type": "string",
        "description": "ADUANET customs office code.",
        "x-latinfo-meaning": "code"
      },
      "declaration_year": {
        "type": "string",
        "description": "Declaration year.",
        "x-latinfo-meaning": "text"
      },
      "declaration_number": {
        "type": "string",
        "description": "Declaration number; retain leading zeros.",
        "x-latinfo-meaning": "identifier"
      },
      "declaration_date": {
        "type": "string",
        "description": "Published declaration date date. Format: YYYYMMDD.",
        "x-latinfo-meaning": "date"
      },
      "operation_date": {
        "type": "string",
        "description": "Published operation date date. Format: YYYYMMDD.",
        "x-latinfo-meaning": "date"
      },
      "series": {
        "type": "string",
        "description": "Goods series within a declaration; not a distinct company.",
        "x-latinfo-meaning": "text"
      },
      "hs_code": {
        "type": "string",
        "description": "Ten-digit national tariff/NANDINA code.",
        "x-latinfo-meaning": "code"
      },
      "description": {
        "type": "string",
        "description": "Published description.",
        "x-latinfo-meaning": "text"
      },
      "country": {
        "type": "string",
        "description": "Origin country for imports; destination country for exports.",
        "x-latinfo-meaning": "text"
      },
      "fob_usd": {
        "type": "string",
        "description": "Published FOB value; no currency conversion is applied. Unit: USD.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "USD"
      },
      "net_weight_kg": {
        "type": "string",
        "description": "Published net goods weight. Unit: kg.",
        "x-latinfo-meaning": "quantity",
        "x-latinfo-unit": "kg"
      },
      "source_file": {
        "type": "string",
        "description": "Original upstream weekly ZIP name for lineage.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "ruc",
      "operation_type",
      "declaration",
      "customs_office",
      "declaration_year",
      "declaration_number",
      "declaration_date",
      "operation_date",
      "series",
      "hs_code",
      "description",
      "country",
      "fob_usd",
      "net_weight_kg",
      "source_file"
    ],
    "additionalProperties": false
  }
}

400Invalid identifier or query. Correct the input before retrying.