DEV Community: Vinícius (Nico) Guedes

The difference between using statements and using declarations in C#

Vinícius (Nico) Guedes — Wed, 21 Dec 2022 15:33:09 +0000

Since its release on C# 8.0 in September 2019, using declarations became the most common way to initialize disposable objects, even being the default suggestion if you’re using Rider with Resharper. Whereas before we would wrap the code within a block, we can now just prefix our variable declaration with using.
I know that this is not a trending topic, but I always find it helpful to read different explanations of the same subject when I'm trying to understand something.

Using statement:

using (var connection = new SqlConnection(connectionString))
{
    ...
}

Using declaration:

using var connection = new SqlConnection(connectionString);

What exactly does “using” do with our variable?

Whether you chose the classic approach (using statement) or using declaration, the end goal is to explicitly dispose your variable, without relying on the Garbage Collector. Something you could also achieve by doing this:

var connection = new SqlConnection(connectionString);
connection.Dispose();

Besides syntax, is there any other difference between those approaches?

Yes. The difference is in the scope!

With the using statement, you’re delimitating the scope of your variable. It gets initialized when you open the block and disposed when you close it. Simple and readable, right? Here's an example of the variable not being available anymore once its code block is closed:

static void TestDbConnectionWithUsingStatementIncorrectScope()
{
    using (var connection = new SqlConnection(connectionString))
    {
        using (var command = new SqlCommand(commandText, connection))
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
    }

    using (var command2 = new SqlCommand(commandText2, connection))
    {
        // Compilation error.
        // The connection object isn't available
        // anymore as it has already been disposed.
    }
}

But how does the Compiler know when to dispose your variable if you just added a using declaration, without defining a block? The compiler will dispose your variable at the end of its current code block when it’s not usable anymore.

static void TestDbConnectionWithUsingDeclaration()
{
    using var connection = new SqlConnection(connectionString);
    using var command = new SqlCommand(commandText, connection);
    command.Connection.Open();
    command.ExecuteNonQuery();

    using var command2 = new SqlCommand(commandText2, connection);
} // Code compiles successfully as all objects
  // will be disposed at this block end

The same could be correctly implemented with using statement. With more lines of code and more code blocks than on the previous version:

static void TestDbConnectionWithUsingStatement()
{
    using (var connection = new SqlConnection(connectionString))
    {
        using (var command = new SqlCommand(commandText, connection))
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        using (var command2 = new SqlCommand(commandText2, connection))
        {

        }
    }
}

It could also be done by explicitly calling the Dispose Method. The disadvantage is that you might forget to dispose one of your objects, and it's not as readable as the previous versions, depending on how many lines of code you have in your Method:

static void TestDbConnectionWithDispose()
{
    var connection = new SqlConnection(connectionString);
    var command = new SqlCommand(commandText, connection);
    command.Connection.Open();
    command.ExecuteNonQuery();

    var command2 = new SqlCommand(commandText2, connection);

    connection.Dispose();
    command.Dispose();
    command2.Dispose();
}

Conclusion: What should I use?

That depends. If you want to decrease the number of scope blocks in your code, go for the using declaration approach. In some specific cases though, where you don’t want your variable to be available in the whole context of your current block (maybe you’re dealing with a big Method in a Legacy application), you’d rather use the using statement, explicitly defining when your variable should live.

How to avoid AutoMapper configuration runtime errors

Vinícius (Nico) Guedes — Tue, 06 Sep 2022 22:19:41 +0000

When working with AutoMapper, we often bump into runtime errors due to invalid mapping configuration, such as this one:

AutoMapper.AutoMapperMappingException: Missing type map configuration or unsupported mapping.

Wouldn't it be great if we could catch those errors before running our application?

AutoMapper actually provides an assertion that we can add to our Unit Tests pipeline and make sure that no runtime error will happen.

If you don't know how to create a Unit Test Project, follow the steps from this article: Getting Started with xUnit.net.

Using xUnit

public class MappingTests
{
    private readonly IConfigurationProvider _configuration;
    private readonly IMapper _mapper;

    public MappingTests()
    {
        _configuration = new MapperConfiguration(config => 
            config.AddProfile<MappingProfile>());

        _mapper = _configuration.CreateMapper();
    }

    [Fact]
    public void ShouldHaveValidConfiguration()
    {
        _configuration.AssertConfigurationIsValid();
    }
}

Using NUnit

public class MappingTests
{
    private readonly IConfigurationProvider _configuration;
    private readonly IMapper _mapper;

    public MappingTests()
    {
        _configuration = new MapperConfiguration(config => 
            config.AddProfile<MappingProfile>());

        _mapper = _configuration.CreateMapper();
    }

    [Test]
    public void ShouldHaveValidConfiguration()
    {
        _configuration.AssertConfigurationIsValid();
    }
}

The NUnit example was taken from the Clean Architecture Template, provided by Jason Taylor.

Please also check out the official AutoMapper Configuration Validation documentation.

Consegui um trabalho remoto no exterior residindo no Brasil, e agora?

Vinícius (Nico) Guedes — Thu, 17 Dec 2020 14:38:59 +0000

Muitas vagas de trabalho remoto no exterior exigem que o candidato esteja residindo naquela localidade, por questões legais. Ser um digital nomad não é tão simples, já que no fim das contas, você precisa ser residente fiscal em algum país. Pense na seguinte situação: você trabalha para uma empresa estadunidense e reside no Brasil, a quem você deve pagar os encargos trabalhistas? Brasil ou Estados Unidos? Não sou contador, mas pela minha trajetória de carreira de residir na Irlanda e depois retornar ao Brasil trabalhando remoto, sei que neste caso o correto seria pagar os encargos ao país onde você reside: Brasil.

Se você está aqui, é porque tem interesse ou até mesmo já fechou contrato com alguma empresa do exterior, e agora precisa saber como fará para receber o seu salário sem ter problemas com a Receita Federal. Portanto vou listar o passo-a-passo para conseguir trabalhar para uma empresa do exterior residindo no Brasil de maneira legal.

Este artigo não se destina a meios de trabalho remoto através de empresas terceirizadoras, pois as mesmas normalmente possuem CNPJ no Brasil e vão decidir o seu regime de contratação.

Sumário

#1: Contrato de trabalho
#2: Abertura de Pessoa Jurídica
#3: Como receber pagamentos?
#4: Gerando uma Invoice em moeda estrangeira
#5: Emissão de Nota Fiscal
#6: (Opcional) Abertura de Conta Bancária Pessoa Jurídica

#1: Contrato de trabalho

É necessário firmar um contrato de trabalho com a empresa contratante. Este contrato conterá o quanto você recebe na moeda local (USD, EUR, GBP) e outras regras que ficarem definidas entre você e o empregador (férias, feriados, etc). Este contrato será muito importante para comprovar a origem dos recursos na sua conta bancária, caso a Receita Federal ou algum banco brasileiro solicite tal informação. Seu contratante provavelmente já possuirá um modelo de contrato pré-estabelecido, presumindo que você não será o primeiro a ser contratado pela organização.

#2: Abertura de Pessoa Jurídica

A empresa do exterior muito provavelmente não possuirá uma entidade registrada no Brasil. Portanto, para receber será necessário abrir uma Pessoa Jurídica aqui, pois pagamentos do exterior devem ser feitos de empresa para empresa.
Neste tópico não há muito segredo, o que eu recomendo é entrar em contato com algum escritório de Contabilidade da sua cidade no Brasil e explicar toda a situação, preferencialmente um escritório que possua experiência com emissão de notas fiscais para o exterior. Fique atento em relação ao código CNAE que escolherá para sua empresa, pois ele indicará se pode ou não enquadrar-se no Simples Nacional, simplificando e reduzindo os encargos. Além disto, defina o quanto quer colaborar com o INSS. Alinhe tudo isto com seu contador.
Aqui em Belo Horizonte, por exemplo, a diferença básica foi a de que, por prestar serviço para o exterior, eu não pago ISS. Acredito que isto pode variar de município para município.
Algumas startups oferecem esse tipo de serviço Online, como a Contabilizei. Nunca utilizei o serviço deles, portanto não se trata de uma recomendação. Fala aí nos comentários se é cliente deles e como tem sido a experiência.

#3: Como receber pagamentos?

Neste tópico, a opção mais tradicional seria contatar seu banco e solicitar a eles um código internacional (IBAN, WIRE, SWIFT, dependendo do país do seu empregador). Não recomendo este processo pois bancos tradicionais cobram taxas abusivas e cada banco possui uma forma de aprovação para recebimento das transferências, como de costume, bem burocráticos.
Do que nós Devs gostamos no setor bancário? Sim, Fintechs! Vou focar nestas. Falarei à respeito das duas plataformas que já utilizei. Uma delas utilizei por cerca de 3 anos (TransferWise) e a outra utilizo há cerca de 5 meses (Remessa Online).

TransferWise

TransferWise é uma empresa com sede em Londres de transferência de dinheiro on-line. Oferece ótimas taxas e uma seleção enorme de moedas disponíveis. Além de câmbio, eles também disponibilizam uma conta de múltiplas moedas, infelizmente até o momento dessa postagem (12/2020), não enviam seus cartões para esta conta a endereços do Brasil, porém os serviços de câmbio estão todos disponíveis em nosso território.

Como receber através do TransferWise?

Ao abrir uma conta no TransferWise, eles te disponibilizarão dados bancários para recebimento de dinheiro nesta conta. Se seu empregador for Europeu da zona do Euro, abra uma conta em Euro e envie o código IBAN ao seu empregador. Se for dos Estados Unidos, passe os dados bancários da conta como número da conta, número WIRE, etc.
No momento de receber o pagamento, emita uma Invoice seguindo os passos descritos em Gerando uma Invoice em moeda estrangeira e encaminhe ao contratante. O TransferWise não irá te solicitar esta invoice.
Seu empregador fará o depósito nesta conta bancária e neste momento você fará uma operação de câmbio na plataforma do TransferWise da sua conta do TW para uma conta bancária brasileira: não precisa ser conta de Pessoa Jurídica.
Após recebimento do valor em Real Brasileiro na sua conta, siga os passos do tópico Emissão de Nota Fiscal.

Vantagens do TransferWise:

Taxas baixas
Agilidade para recebimento. Recebimentos em USD estão demorando cerca de 1 dia (2022). Na época que recebia em Euro (2020), girava em torno de 3 dias.

Desvantagens do TransferWise:

Não oferecem conta de PJ no Brasil. Isto não é um empecilho pois contabilmente não há problema em receber como Pessoa Física e depois emitir uma nota fiscal pela sua empresa.
O Banco Rendimento, que faz a intermediação pelo TransferWise, pode em algum momento te solicitar documentação comprovando a origem destes recursos. Mas isto é simples, basta encaminhar o contrato de trabalho firmado, suas declarações de IR anteriores, documento de identificação, etc. Passei por esse processo e tive que aguardar cerca de uma semana para liberação do meu salário quando ocorrido.

Remessa Online

Empresa brasileira fundada em 2016 com o objetivo de facilitar recebimento de remessas estrangeiras em diversas moedas.

Como receber através da Remessa Online?

Abra uma conta de Pessoa Jurídica na Remessa Online, caso o limite da conta de Pessoa Física não seja suficiente. Abordaremos o processo de PJ aqui. O processo de abertura da conta em si é simples e existem diversos posts em blogs pela internet explicando como fazer, bem como vídeos no YouTube. Tenha em mãos o contrato estabelecido com seu contratante, pois a Remessa Online irá solicitar.
A Remessa Online apenas transfere os recursos após operação de câmbio para o mesmo titular. Para PF, sua conta bancária deve estar no mesmo CPF, para PJ, no mesmo CNPJ. Portanto, é necessário abrir uma conta bancária PJ. Veja o que estou falando à respeito disso no tópico (Opcional) Abertura de Conta Bancária Pessoa Jurídica. Se optou por usar a Remessa Online PJ, este tópico não é opcional rsrs.
Passe para seu contratante os dados bancários da sua conta da Remessa Online. Mesmo processo do TransferWise até aqui, IBAN para Europa, se não me engano WIRE para USA.
No momento de receber o pagamento, emita uma Invoice seguindo os passos descritos em Gerando uma Invoice em moeda estrangeira. Aqui vem uma diferença importante em relação ao TransferWise, a Remessa Online irá solicitar que faça o upload desta invoice todas as vezes que receber uma remessa.
Após recebimento do valor em Real Brasileiro na sua conta, siga os passos do tópico Emissão de Nota Fiscal.

Vantagens da Remessa Online:

Tudo feito pela conta de pessoa jurídica, processo bem transparente e sem surpresas.
Também oferece uma conta de pessoa física, porém com limite baixo. Foi útil pra mim enquanto aguardava a abertura da minha conta bancária de PJ.

Desvantagens da Remessa Online:

Taxas um pouco mais altas do que do TransferWise. Porém, ao receber pelo menos uma remessa mensal, eles enviam um cupom de desconto no seu e-mail. Lembre-se sempre de aplicar este cupom, dessa forma as taxas ficam bem próximas do TransferWise.
Necessidade de ter uma conta bancária PJ para recebimento das remessas na conta de PJ.
No meu caso o processo todo tem demorado cerca de uma semana. Por fornecerem um código IBAN brasileiro, demora de 2 a 3 dias para cair na conta da Remessa Online e mais uns 2 dias para cair na minha conta bancária de PJ.

#4: Gerando uma Invoice em moeda estrangeira

A Invoice basicamente é a fatura. Nela você descreve os serviços prestados e o valor em moeda estrangeira.
Invoice e Nota Fiscal são dois documentos distintos. Um não elimina o outro.
Eu recomendo a utilização do Invoice Ninja (invoiceninja.com). É grátis e bem simples.
Basta criar uma conta, preencher os dados do seu contratante e da sua empresa, criar uma nova invoice, gerar o PDF e encaminhar ao seu empregador. Esta mesma invoice poderá ser utilizada para comprovar a origem dos recursos caso receba o pagamento através da Remessa Online.

#5: Emissão de Nota Fiscal

Nos passos anteriores expliquei que fechei contrato com um escritório de Contabilidade daqui de Belo Horizonte, certo? No momento da abertura da minha empresa, assinei diversas procurações, fui ao cartório inúmeras vezes, na Receita Federal e etc, com o objetivo de dar plenos poderes a eles para assinarem digitalmente documentos por mim. Portanto, não possuo certificado digital.
Dado este contexto, sempre que preciso de uma nota fiscal, encaminho para a Contabilidade um e-mail contendo os seguintes dados:

Valor exato em R$ que caiu na minha conta. Lembre-se: para a receita o que importa é o valor em Real.
Data do recebimento (na conta bancária no Brasil).
Nome do meu contratante e endereço da empresa na Irlanda.
Sempre incluo um lembrete de que o meu cliente não está localizado no Brasil, então portanto não há cobrança de ISS. Novamente, verifique com sua Contabilidade.

#6: (Opcional) Abertura de Conta Bancária Pessoa Jurídica

Se o seu faturamento for superior a 80 mil reais anuais, sua PJ não será MEI, provavelmente será uma Microempresa (ME).
No momento que escrevi este artigo, houve uma grande dificuldade para encontrar conta PJ gratuita para empresas que não fossem MEI.
Porém, hoje, já é possível abrir contas PJ gratuitas no Inter, Nubank e Conta Simples.
As taxas de manutenção dos bancos tradicionais variam de 50 a 140 reais, além da burocracia que não me agrada.

Pronto! Espero ter ajudado e esclarecido este processo. Se tiver alguma dúvida ou sugestão, deixe aí nos comentários.