Tabela ORIN no SAP Business One (Devolução de nota fiscal de saída (cabeçalho))

Campos-chave da ORIN

Como a ORIN se relaciona com outras tabelas

ORIN é o cabeçalho e a RIN1 as linhas, relacionadas por DocEntry. O vínculo com a nota fiscal creditada não fica no cabeçalho: cada linha da RIN1 guarda BaseType, BaseEntry e BaseLine. BaseType = 13 significa que a linha foi copiada de uma nota fiscal de saída (BaseEntry = OINV.DocEntry), 16 de uma devolução (ORDN), e -1 que a devolução foi digitada manualmente, sem documento base. Nas versões atuais, cancelar uma nota fiscal de saída não cria uma linha na ORIN: o SAP B1 grava um documento de cancelamento na OINV com CANCELED = 'C'.

Joins mais comuns

• ORIN T0 INNER JOIN RIN1 T1 ON T0.DocEntry = T1.DocEntry (linhas)
• RIN1 T1 INNER JOIN OINV T2 ON T1.BaseType = 13 AND T1.BaseEntry = T2.DocEntry (nota fiscal de saída original)
• ORIN T0 INNER JOIN OCRD T3 ON T0.CardCode = T3.CardCode (cadastro de clientes)
• ORIN T0 LEFT JOIN OSLP T4 ON T0.SlpCode = T4.SlpCode (vendedor)

Quando usar a tabela ORIN

Todo relatório de vendas líquidas precisa da ORIN: notas fiscais da OINV menos devoluções da ORIN, com os mesmos nomes de coluna, então um UNION ALL resolve. O financeiro usa a tabela para conferir créditos em aberto nos saldos de clientes, e os gerentes comerciais para ver quais clientes devolvem mercadoria ou recebem correções de preço com mais frequência. No faturamento eletrônico, a ORIN é a origem da nota de crédito enviada à autoridade fiscal, que quase sempre exige a referência à nota fiscal original.

Consulta de exemplo: devoluções com a nota fiscal que creditam

SQL Server

SELECT T0.DocNum AS CreditMemo, T0.DocDate, T0.CardCode, T0.CardName,
  T0.DocTotal, T2.DocNum AS InvoiceNum, T2.DocDate AS InvoiceDate
FROM ORIN T0
LEFT JOIN (SELECT DISTINCT DocEntry, BaseEntry FROM RIN1 WHERE BaseType = 13) T1
  ON T0.DocEntry = T1.DocEntry
LEFT JOIN OINV T2 ON T1.BaseEntry = T2.DocEntry
WHERE T0.CANCELED = 'N' AND T0.DocDate >= '20260101'
ORDER BY T0.DocDate

SAP HANA (nomes de colunas entre aspas duplas)

SELECT T0."DocNum" AS "CreditMemo", T0."DocDate", T0."CardCode", T0."CardName",
  T0."DocTotal", T2."DocNum" AS "InvoiceNum", T2."DocDate" AS "InvoiceDate"
FROM ORIN T0
LEFT JOIN (SELECT DISTINCT "DocEntry", "BaseEntry" FROM RIN1 WHERE "BaseType" = 13) T1
  ON T0."DocEntry" = T1."DocEntry"
LEFT JOIN OINV T2 ON T1."BaseEntry" = T2."DocEntry"
WHERE T0."CANCELED" = 'N' AND T0."DocDate" >= '20260101'
ORDER BY T0."DocDate"

Cole qualquer uma das duas versões em Ferramentas → Consultas → Gerador de consultas. Precisa do outro dialeto para a sua própria consulta? Use o conversor de SQL para HANA.

Erro comum: Devoluções digitadas manualmente não têm vínculo com a nota fiscal

Quando um usuário cria a devolução do zero em vez de copiá-la da nota fiscal (Copiar de, ou clique direito Copiar para), cada linha da RIN1 recebe BaseType = -1 e nenhum BaseEntry. Na consulta acima, essas linhas aparecem com InvoiceNum vazio. Os relatórios não conseguem associar o crédito a uma venda, e os add-ons de faturamento eletrônico falham porque a nota de crédito precisa referenciar a nota fiscal original: a referência de faturamento da ZATCA, o numDocModificado do SRI, o complemento de referência do FEL na Guatemala ou o CUFE original no Panamá. Bloqueie na origem com uma regra na SBO_SP_TransactionNotification para o tipo de objeto 14 que rejeite linhas da RIN1 com BaseType = -1, ou exija o número da nota fiscal original em um UDF. Veja Exemplos de SBO_SP_TransactionNotification para SQL Server e HANA.

Consultas prontas que usam a ORIN (em inglês)

• Sales by customer for a date range: Net sales per customer (invoices minus credit notes) between two dates, highest first.
• Customer balances: All customers with a non-zero account balance, with credit limit and phone.

Tabelas relacionadas

OINV (Nota fiscal de saída (cabeçalho)) · INV1 (Nota fiscal de saída (linhas)) · OCRD (Parceiros de negócios) · pesquisar todas as tabelas do SAP Business One

Fontes: Documentação e SDK do SAP Business One (referência das tabelas do banco de dados da DI API), SAP Help Portal.