Consultar contribuyente

GET

api

taxpayers

{country}

{documentNumber}

Consultar contribuyente

curl --request GET \
  --url https://api.emify.co/api/taxpayers/{country}/{documentNumber} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.emify.co/api/taxpayers/{country}/{documentNumber}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.emify.co/api/taxpayers/{country}/{documentNumber}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.emify.co/api/taxpayers/{country}/{documentNumber}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.emify.co/api/taxpayers/{country}/{documentNumber}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "document_number": "76354771-9",
  "legal_name": "EMPRESA EJEMPLO SPA",
  "primary_activity": "VENTA AL POR MAYOR NO ESPECIALIZADA",
  "activities": [
    "VENTA AL POR MAYOR NO ESPECIALIZADA"
  ],
  "email": "FacturacionMIPYME@sii.cl",
  "address": {
    "address": "AV PROVIDENCIA 1234, OFICINA 501",
    "city": "LAS CONDES",
    "state": "CL-RM",
    "country": "CL"
  },
  "addresses": null,
  "taxes": null,
  "tax_condition": null
}

Authorizations

X-Api-Key

string

header

required

Path Parameters

country

string

required

Código ISO 3166-1 alfa-2 del país: CL o AR

documentNumber

string

required

Número de documento tributario: RUT con guion en Chile (76354771-9), CUIT con o sin guiones en Argentina (20111111112)

Query Parameters

apiKey

object

required

Show child attributes

Response

Contribuyente encontrado

document_number

string

Número de documento tributario del contribuyente

Example:

76543210

legal_name

string

Razón social del contribuyente

Example:

"Empresa Ejemplo SpA"

primary_activity

string

Actividad económica principal del contribuyente

Example:

"Servicios de tecnología de información"

activities

string[]

Lista de actividades económicas del contribuyente

string

Direccion de intercambio de documentos electronicos del contribuyente, segun la publica el ente tributario. NO es un correo de contacto comercial: en Chile suele ser la casilla del portal gratuito del SII o la del proveedor de facturacion electronica del contribuyente, y una misma direccion la comparten cientos de miles de contribuyentes. Sirve para enviarle el DTE; no para contactar a la empresa.

Example:

"FacturacionMIPYME@sii.cl"

address

object

Domicilio fiscal con los campos de recipient.address de la emision: se manda entero a una factura del mismo pais

Show child attributes

addresses

object[]

Todos los domicilios que publica el ente tributario. Null en paises cuya fuente no los trae (Chile)

Show child attributes

taxes

object[]

Impuestos en los que el contribuyente esta inscripto hoy (solo los activos). Null en paises cuya fuente no los trae (Chile)

Show child attributes

tax_condition

string

Condicion IVA del contribuyente, con los codigos que acepta recipient.tax_information.tax_condition al emitir. Se deriva de los impuestos activos. Null si el padron no permite determinarla, y en paises cuya fuente no la trae (Chile). Es un punto de partida: la condicion del receptor la confirma el emisor

Example:

"RI"

Consultar contribuyente

curl --request GET \
  --url https://api.emify.co/api/taxpayers/{country}/{documentNumber} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.emify.co/api/taxpayers/{country}/{documentNumber}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.emify.co/api/taxpayers/{country}/{documentNumber}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.emify.co/api/taxpayers/{country}/{documentNumber}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.emify.co/api/taxpayers/{country}/{documentNumber}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "document_number": "76354771-9",
  "legal_name": "EMPRESA EJEMPLO SPA",
  "primary_activity": "VENTA AL POR MAYOR NO ESPECIALIZADA",
  "activities": [
    "VENTA AL POR MAYOR NO ESPECIALIZADA"
  ],
  "email": "FacturacionMIPYME@sii.cl",
  "address": {
    "address": "AV PROVIDENCIA 1234, OFICINA 501",
    "city": "LAS CONDES",
    "state": "CL-RM",
    "country": "CL"
  },
  "addresses": null,
  "taxes": null,
  "tax_condition": null
}

Introducción

Endpoints

Consultar contribuyente

Authorizations

Path Parameters

Query Parameters

Response