Cadastro de Contratos API 1.0

Serviço destinado a incluir contratos.

Parâmetros do serviço

ElementoTipoOcorrênciaDescrição
apiKeystringobrigatórioChave gerada para identificar sua empresa
contratoXML (1)-obrigatórioDados do contrato no formato XML conforme layout

(1) - Layout do parâmetro contratoXML 


<?xml version="1.0" encoding="UTF-8" ?>
<contrato>
	<cliente>
		<nome>Teste Contrato</nome>
		<tipoPessoa>J</tipoPessoa>
		<cpf_cnpj>00000000000000</cpf_cnpj>
		<ie_rg>1111111111</ie_rg>
		<endereco>Rua Visconde</endereco>
		<numero>123</numero>
		<complemento></complemento>
		<bairro>Cidade Alta</bairro>
		<cep>95.700-00</cep>
		<cidade>BENTO GONÇALVES</cidade>
		<uf>RS</uf>
		<fone>123456789</fone>
		<email>teste@teste.com.br</email>
	</cliente>
	<descricao>Descrição do Contrato</descricao>
	<data_contrato>25/07/2011</data_contrato>
	<dia_vencimento>15</dia_vencimento>
	<valor>56,58</valor>
	<mes_vencimento>C</mes_vencimento>
	<periodicidade>1</periodicidade>
	<emite_nf>N</emite_nf>
	<produto>caderno azul</produto>
	<texto_nf>Texto para nota fiscal</texto_nf>
	<periodo_impressao>C</periodo_impressao>
	<data_renovacao>25/09/2012</data_renovacao>
	<categoria>Serviços gerais</categoria>
	<obs>Observações</obs>
	<mes_termino>6</mes_termino>
	<ano_termino>2012</ano_termino>
	<vendedor>marcos Auguto Grzeca</vendedor>
	<nro_parcelas>5</nro_parcelas>
</contrato>

Exemplos de chamada da API

Exemplo da chamada em PHP 


$url = 'http://api.tiny.com.br/recepcao.contrato';
$xml = '<contrato>...</contrato>';

$data = "apiKey='coloque aqui a sua chave da api'&contratoXML='$xml'";

enviarPedidoREST($url, $data);

function enviarPedidoREST($url, $data, $optional_headers = null) {
	$params = array('http' => array(
					'method' => 'POST',
					'content' => $data
				));
	if ($optional_headers !== null) {
		$params['http']['header'] = $optional_headers;
	}
	$ctx = stream_context_create($params);
	$fp = @fopen($url, 'rb', false, $ctx);
	if (!$fp) {
		throw new Exception("Problema com $url, $php_errormsg");
	}
	$response = @stream_get_contents($fp);
	if ($response === false) {
		throw new Exception("Problema obtendo retorno de $url, $php_errormsg");
	}
	return $response;
}

Exemplo da chamada em Python 


import urllib

xml = '<contrato>...</contrato>';

params = {"apiKey": "coloque aqui a sua chave da api", "contratoXML": xml}

query = urllib.urlencode(params)

url = "http://api.tiny.com.br/recepcao.contrato"
f = urllib.urlopen(url, query)

contents = f.read()
f.close()

print contents