A solução SPED Fiscal da TecnoSpeed facilita a geração do arquivo SPED no seu software, e apresenta um diagnóstico completo do arquivo gerado. Deste modo, a solução reduz seu esforço de suporte com o cliente e não exige que seu time domine a parte fiscal para desenvolver.

Integrado com a solução SPED Fiscal, seu sistema deve enviar blocos de informação através de um layout simplificado ao longo do mês.

Quando solicitada, nossa API executa uma complexa validação das informações, identificando possíveis erros no arquivo na parte de estrutura, combinação de informações e totalização de registros.

Se as informações estiverem corretas, você poderá baixar o arquivo .txt do SPED, pronto para enviar à SEFAZ!

Existem duas formas de integrar a solução SPED Fiscal em seu software:

• Componente
• API

Lembrando que para utilizar o componente é necessário o Token da TecnoAccount

• Criar novo usuário no TecnoAccount
• Fazer login no TecnoAccount

Componente

Com uma biblioteca de métodos instanciada em seu projeto, seu software gera arquivos de texto contendo as informações necessárias e chama os métodos para iniciar uma nova apuração, enviar estes dados para nossa API, validar as informações, consultar a apuração e baixar o arquivo SPED.

O Componente da solução SPED possui os seguintes métodos disponíveis:

• IniciarApuracao
• EnviarRegistros
• GerarApuracao
• ConsultarApuracao

IniciarApuracao

O método IniciarApuracao é utilizado sempre que for necessário gerar um novo arquivo SPED. Ela retornará o número de protocolo que utilizaremos para enviar os registros àquele arquivo e gerar o arquivo SPED ao fim da apuração.

Método: IniciarApuracao(): IspdRetIniciarApuracao;

Retorno: Objeto tipo IspdRetIniciarApuracao com atributos Protocolo e Mensagem

Requisitos*: NomeArquivo; DataInicio; DataFim; CNPJEmissor

* É necessário serem configurados nas propriedades do componente

Link de exemplos

EnviarRegistros

O método EnviarRegistros é utilizado sempre que for necessário enviar um novo registro à um arquivo SPED já iniciado.

Método: EnviarRegistros(const aProtocolo: WideString, const aTX2: WideString):IspdRetEnviarRegistros;

Parâmetros:

    Aprotocolo:WideString - Protocolo de controle, recebido ao iniciar uma apuração

    aTX2:WideString - TX2 do registro a ser enviado, seguindo o Dicionário de Dados

Retorno: Objeto tipo IspdRetEnviarRegistros com atributos Protocolo e Mensagem

Requisitos: Para enviar um registro, é necessário referenciar um número de protocolo de uma apuração válida.

Link de exemplos

GerarApuracao

O método GerarApuracao é utilizado sempre que for necessário gerar um novo arquivo SPED. Ela retornará o número de protocolo que utilizaremos para consultar o arquivo SPED.

Método: GerarApuracao(aProtocolo: WideString):IspdRetGerarApuracao;

Parâmetros:

    Aprotocolo:WideString - Protocolo de controle, recebido ao iniciar uma apuração

Retorno: Objeto tipo IspdRetGerarApuracas com atributos Protocolo e Mensagem

Requisitos: Para enviar um registro, é necessário referenciar um número de protocolo de uma apuração válida.

Link de exemplos

ConsultarApuracao

O método ConsultarApuracao é utilizado sempre que for necessário consultar um arquivo SPED que a geração já foi solicitada.

Método: ConsultarApuracao(aProtocolo: WideString, aCaminhoArquivos: WideString): IspdRetConsultarApuracao;

Parâmetros:

    Aprotocolo:WideString - Protocolo de controle, recebido ao iniciar uma apuração

    aCaminhoArquivos:WideString - Caminho que será utilizado para salvar os arquivos do retorno

Retorno: Objeto tipo IspdRetConsultarApuracao com atributos Protocolo, Mensagem, NomeArquivo, Codigo

Requisitos: Para enviar um registro, é necessário referenciar um número de protocolo de uma apuração válida.

Link de exemplo

API

Se sua linguagem de programação permitir, é possível comunicar-se diretamente com nossa API Web. Basta utilizar requisições HTTPS, tanto para iniciar uma apuração e enviar os blocos de informação, quanto para solicitar as validações, consultar a apuração e fazer o download do arquivo SPED.

A Tecnospeed conta com um repositório oficial no GitHub, disponibilizamos uma demonstração da utilização da API do SPED, Clique aqui para acessar.

A API da solução SPED possui as seguintes rotas disponíveis:

• Iniciar
• Registros
• Gerar
• Protocolo

Para facilitar, preparamos para vocês uma coleção de requisições. Com o Postman, basta importar o seguinte link:

Iniciar

A rota Iniciar é utilizada sempre que for necessário gerar um novo arquivo SPED. Ela retornará o número de protocolo que utilizaremos para enviar os registros àquele arquivo e gerar o arquivo SPED ao fim da apuração.

Post: https://api.tecnospeed.com.br/sped-fiscal/iniciar

Header:

Body:

Exemplo de JSON:

{
    "data_inicio": "01-01-2018" ,
    "data_fim": "30-01-2018",
    "cnpj_emissor": "10101501504873",
    "cnpj_sh": "29062609000177",
    "arquivo": "Arquivo123.txt"
}

Retorno:

Exemplo de JSON:

{
    "message": "Registro inserido com sucesso!" ,
    "data": {
        "_id": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "arquivo": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "data_inicio": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "data_fim": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "cnpj_emissor": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "cnpj_sh": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "data_criacao": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        " status": {
        " codigo": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        " descricao": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        },
    "blocos": []
    }
}

Registros

A rota Registros é utilizada sempre que for necessário enviar um novo registro à um arquivo SPED já iniciado.

Post: https://api.tecnospeed.com.br/sped-fiscal/registros/ID do arquivo SPED

Header:

Body:

Exemplo de JSON:

{
    "tx2": [ "INCLUIR0000\nCOD_VER_1=015\nCOD_FIN_2=0\nDT_INI_3=01452018\nDT_FIN_4=30112018\nNOME_5=TECNOSPEED SA\nCNPJ_6=0000000\nCPF_7=\nUF_8=PR\nIE_9=1111111119\nCOD_MUN_10=4314902\nIM_11=\nSUFRAMA_12=\nIND_PERFIL_13=A\nIND_ATIV_14=1\nSALVAR0000"
]
}

Retorno:

Exemplo de retorno:

{
    "message": "Bloco inserido!",
    "data": {
        "_id": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "blocos": [
            {
            "tx2": "INCLUIR0000\nCOD_VER_1=015\nCOD_FIN_2=0\nDT_INI_3=01452018\nDT_FIN_4=30112018\nNOME_5=TECNOSPEED SA\nCNPJ_6=0000000\nCPF_7=\nUF_8=PR\nIE_9=1111111119\nCOD_MUN_10=4314902\nIM_11=\nSUFRAMA_12=\nIND_PERFIL_13=A\nIND_ATIV_14=1\nSALVAR0000",
        "_id: "IDREG-ffe1dbc9-8332-43a8-8a96-60d02192ace8",
            }
        ]
    }
}

Gerar

A rota Gerar é utilizada sempre que for necessário gerar um novo arquivo SPED. Ela retornará o número de protocolo que utilizaremos para consultar o arquivo SPED.

Post: https://api.tecnospeed.com.br/sped-fiscal/gerar/ID do arquivo SPED

Header:

Retorno:

Exemplo de retorno:

{
    "message": "Iniciado processo de geração do sped!",
    "data": {
        "_id": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
        "status": {
            "codigo": "10002",
            "descricao": "EM PROCESSAMENTO",
        },
        "data_alteracao": "1526589442543"
    }
}

Protocolo

A rota Protocolo é utilizada sempre que for necessário consultar um arquivo SPED que a geração já foi solicitada.

Post: https://api.tecnospeed.com.br/sped-fiscal/protocolo/ID do arquivo SPED

Header:

Retorno:

Exemplo de retorno:

{
 "data": {
 "_id": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "arquivo": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "data_inicio": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "data_fim": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "cnpj_emissor": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "cnpj_sh": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "data_criacao": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "status": {
 "codigo": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 "descricao": "1db5f2c5-7ea6-4a65-bbeb-a2f3a446b2b0",
 },
 "blocos": [
 {
 "tx2": "INCLUIR0000\nCOD_VER_1=012\nCOD_FIN_2=0\nDT_INI_3=01112018\nDT_FIN_4=30112018\nNOME_5=TECNOSPEED SA\nCNPJ_6=0000000\nCPF_7=\nUF_8=PR\nIE_9=1111111119\nCOD_MUN_10=4314902\nIM_11=\nSUFRAMA_12=\nIND_PERFIL_13=A\nIND_ATIV_14=1\nSALVAR0000"
 "_id": "IDREG-ffe1dbc9-8332-43a8-8a96-60d02192ace8",
 }
 ],
 "data_alteracao": "1526589442543",
 "link_arquivo": "https://s3.amazonaws.com/sped-fiscal-production/2018-5/6b9ad1ff-8e01-4eea-add7-becceb926759.zip",
 "link_erros": "https://s3.amazonaws.com/sped-fiscal-production/2018-5/6b9ad1ff-8e01-4eea-add7-becceb926759.zip",
 }
}